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1*0 £I£«ii£iMIiM 



Ih^. a^rfor^ance '^eportini Facility (PRFI is an Inttgrated 
oerforTsnce raoortinj package for I^O$/V£« Sone p^rtlofis of P»F 
rjn o?i -^ns/yi If) 180 stat« mh\\% th« r«st of the package 
curr-^ntlv runs In IIU stttt yocler HOS/170* FRF Is Intended to fo« 
3 '!5odMHr syste-n flitch can fea extended Into a fyll siiort and long 
tarii o^f^offflanc^ traeklng systtis. 



lh?f syrrent PRF is biss^d on th% PHF liarclMars option for CYBil 
i*^?. In the longer tan* It n\\\ accapt ptrfornancs data froi 
otsi^r sayrets and walntiln « parforisinc® ciatibtsa.- 
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1,3 ?Rf o^:»^vi^y 

1.1 PH? H^aO'ilAR^; 
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HFI is a CYS£^ 180 hard>*8r€ 
ircl*iara coynters and event 
s data about t^e syste-i» 

events niay be tlired and 
n soft«i4ra ^^*nts v^ltbin 
allied by insertln*i kevpolnt 

ae coMscted throy^jh th€ 
s s combination of hnr^MBre. 

Is i aoo4 a^apols of ap 



1.1.1 P^F COUNTiiS 



ffiP liar<li«ar« contains elgbt 32"bit counters ^filcli may count 
hardware ever^ts and tlue system stttas. Tb@ list of tvants md 
stitts sypporttd Is wodel dependent and there Is a stlectlon code 
assoclttad with aicli one. A n?nlted amoynt of signal coi«teinstlon 
Is allowed through A/8 counter pairings and appropriate control 
C0cl«s. £¥«nt/stata stitctlon and signti combination ir« 
controlltij throufh settings In register 22. 



1.1.1.1 UL^LBtlltMlQ^Ll^t 



To fe*! supp II ad. 



1.1.2 KgyPOIHT INSTI^yCTIONS 



Keypolnts are special 18© instructions which place an Indication 
of s I cinl f I cint soft^tsra evtnts Into tht FIFO buffer In PHf 
hardware or cause a .keypofnt trap to allo^ the data to be 
collected by softi^are* Th€S^ Instructions act as NO-OPs to the 
MOS/¥t software unless keypoint traps are enabled. In any system 
with tha PHF hm:6wnr€ option? h%rdiMB.re collection rather than 
softi^are collection should be usad as there Is almost no system 
overhesd Involved In gathering the perfor:mance data. 

By convent ion» kiypolnts art used to mark the entry and exit 
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1«§ PtF OVStVlgW 

l.l.E KEYPOIMT IHSTRUCTIOHS 



points of lasjor 0/S intJ prodyet set roytlnts* to ftig ynysyil 
events of hl§f\ l»portarjc€# and to Ir^dlcate significant events for 
fltfoygglni* This nee tianisffl pro^ldts a vtr^ Iom overhttd system 
tracinf mectian Isw as msII as a performance trmcking facility. 



i«l«3 P1F KiYPOIHT BUFFg: 



P^F fits a circylif avtnt byffar ustd to tiold Ntypolr^t diti for 
collection along Mith an assaci ttsd tlms stB-mp* Tlie exact slis 
of -tills feyff«r Is isodtl -<lapend@nt as sisown beloMt 

825 16 keypolnts 

835 16 ^typolnts 

855 16 kevpolnts 

. Theta Ii-2^ keypolnts 
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.*2 Eir.Sill^cillLLIIIIiai 



PMF ©ountar ir^i k^ypolnt dtti may ist eolltettd 
program on N0$/170» CPKPHOS optratss in q 
flapsnclinf on 4^tistN«r ksypolrjt €olltctlon Is seis 
keypoint eollectlor^ Is not stltcttd* CPKPHQ 
program CPHF) to Initialize coyntsr collection 
22 and tfitn tli# fP progrnm drops oyt« CPK 
called up again Mhan the ooynters are to ^be 
keypoint oolltstlon Is sel«at«d* tlit PP pr 
resident to contlnuoysly coMeet tlit eontants 
byffar as it Is bsing f II lad. 
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1 wO 






DATA RtDtJCTIQN 



1.3 Ei£«aii4^i£2yi:iiii 



Ttiart are owrrtntl:^ two components of PMF data rail«otloni» tti« 
Primary Otta Radyctlcn Pickage tod tfit CaH ^oilfsls Syst«»« Tli« 
Prliitry Otti tsilystlon Ptckift Is dsslgned to giva overview 
Information about sfstan baliaylour durinf tlis ksypoliit colltctlon 
artd ttie Call Apafysls Systeii gives iilorolevel tliulng Inf oriatior^ 
an tlia optr itlor> of prootdyrts wltlilfi ilO$/V£ %nii Its pro^yct s«t« 
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2. iliIEaitI-.£CIMEiiIii3iS.-iill^fiyiO.£LiiiI 



Tt^t CYSfcR 18§ Systsm Interfist Standard CSISI dtserlfeas 

coii\?tntror^s for th« pltctfient of kaypolots within trie 0/S and 

product s«t iia«ils«rs« Furthtr doeyiitr^ttt f on Is foynd in the 
latast NOS/¥£ Heipfyl Hints clocyniant. 
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.^ K6Y?1I^T CnnVEHTIUNS AND SyiOElIHES 
•1 K^yPII^T C14SSSS 



:* 1, 



IS£I£aiiI«kL41SiI 



The 180 hardi^ire ailovis 16 keypoint classes ao^ collactlcn of 

ktypolots Is sontroHtd by « kaypoiot lask Iri tht task's «Kslitnia 
package* Only tl^ose keypolnts whose class natclies one of the 
cfissts s?»t In the keypoint ii«sk hIM foe eoltsctsd by either 
htrcl^are or softv^art oolltstion* This tllons tSi# kaypoliit 
classas to iefLie a collection hierarcliy* The foHoi^Ing table 
stioi^s tl^e ki»yooint class msslmm%nts* 



kJ.JiES 



. S Sil —£ 2£ H-«. -——.-.—-,—-.-.«.«,■-.--..-. -..—-.«. 
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1/S debug 
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0/3 P4S CPerforiiincs Analysis S«ylc«s) 
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Product set data 
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Product set procedyre entry 
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Product s«t proctdyrt «Mlt 
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Product s^t debug 
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5?ss«fysfi for end ysers 
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PHF hardware start/stop control 
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r. • 



ll£I£QiiI^ia£MIi£l£aJ-Mi-aiI4^£iiLi5 
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2.0 KSVPOI^T Cr»^?VeNTiaNS AND SUIDELINSS 
£♦3 CY3IL K'^yPni^n IMTi^IMSIC 



a. 3 i;iaiuiiiiEami.iiisiiii£ 



C¥SIl provides an intrinsic to ger^arate keypolnt Instructions 
^Ifiotiy fro« CYBIl coda* Tfils Ifitrlosic Is ys«d In con jyo ctl oil 
*«l tia staridard keypuint common d^Qk declarations to generttt tfif 
tctytl ktyf^oint InstryctioRS present in NOS/VE snd product set 
code* The forw of tlis Intrinsic Is as folloMSt 

iKifPQINTI ksypolnt. class.* osk$p * data* keypolnt^l d) | 
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2«c KEf^oiiT co^vf>4Tio^4s km miMiinss 

E.4 KtYP3lMT €0^10^4 9HCK STRIJCTURS 





2.4 !i£X£aiai-.aoa^ai«o^kE«siEykiii£ 

Thars are t stmdard set of Qomm-on decks provldsd f^r yse by 0/S 
incl Pfodyst Sit divtloptfs In ir^str witeritiiig their co<i«« In 
addition*' tliert ar® stanclird rules for adding keypoint 
dascrtPtloii csmiior^ clacks for' other artas Mhictli art' fc^ing 
l?aypo Ir^tsci* The cyrrantly dtfl^ad common decks ^re foyod In 
HQSl^gPl mil OSIPI for NQS/V€ tnd l?i OSIPI and PSCOMPL for tlie 
product set* 



2,4. a KcTPOIiT CLASS COH^O^ DICKS 

There are tliree siain coiriron decks ustd to d«fine tfie classes for 
A MOS/i/r system, OSDK&yS I r^ NOS¥gl>L, OSDKSYC In OSLPI* and 
^>D<S^C In s»SC01l>L* GSDKgYS conttins tlit liistar ring® 
declaration «nd OSDKSYC and PSOKEYC contain thB actual class 
dacMrations ^or the O/S and product sat rsspectlvely* 

Listings of tNast tNr@t co^won dacks follow^ 

CONST 

C Key point Classes J 

C 

C The 16 keypoint classes supported by the Nardi^are tr « partitlontd 

C hat^ttn tbn Systti* Prodyct Sat and User as foliOMs» 

osk$systtm_cl ass = C •• 3 >* 

oskSpr'odyct.set. class = 6 C 6 •• '10 >.» 

osk$ys«r_c I ass * 11 C 11 .» 14 ># 

oskSpi^f^contr I = 15j 

i Keypoint HultJpllerJ 

C 

C By convention* the 32 bit keypoint code supported by the hardware 

C is spilt into two fields* The right field contains a keypoint 

i identifier which Is used to Identify a function within a ksypolnt cltss. 

C For e^affiple* If a particular kaypoint class represents exit fro?^ a 

C procedure* then the keypoint identifier ^Ight Identify exit from 

C orocsdure 4 versus exit frosn procedure i. 

C The I aft field is used as i data parameter appropriate to the 

C function identified by the keypoint identifier. In th€ procedure exit 
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^.i KcfPOm CONVsNTIONS AND OlUDElIH^rS 
2.%.1 KiYPlINT CLASS COf^inN DECKS 



C axiispla al30¥e;» tlie data paraiitter field flight foe ysed to ind ate tfie 

C status of th-B prooedyre call* 

■C The ktypoint nyltlpller is ijsed to partition ttit tceypoiat ecde 

C into th« two fltlils« Thi data ptraptttf siiould be litiltlplisd bf th« 

C kej^point iiultipller to prtvtnt it frow oftriapplng tfi« keypoint 

C i clan t If I er field. 



CONST 

. osk%m « 40961 

ClSSi£I£ 

CDtflna KSfPOIHT CLASS Codes. 

C3HST 

oskSdata « oskSsysten.cl iss + §# C 3S - DATA k€ypoint> 

oskSynysyal = oskSsystem. cl uss + 1> CU OS - Urjiisyal ka^point class.l 

oskSentry * oskSs^s teis^o lass ■»- 2# C£ OS - Standard ktypoint Cfated cr Jitjor InttrniUl 

oskSe^lt = osk$systei_class 4- 3.9 £K OS - Exit kaypoint> 

osk$dt^yi = osk$syst€i. class + 4> CO OS - B%bu§ ktypolnt.l 

oskSresarved = osk$sys tew^o I tss 4- if CR OS - Rtservtd li;typolnt»} 

To ba sypp I I ©d.« 



2.^.2 KSTPOINT- IDENTIrliR COHHON DECKS 



Tliere are two cofi^inorj decks MhlcN declare tlie Identifier ranges 
for tha a/S tnd product s^t$« Ttitse trt OSOKEYD In. OSIPI tnd 
PSDKiYO In PSCOHPL for the 0/S and product sets respectively. 
Tlier© is a required convtntlon for til range definitions that 
they be of the forP XXkSbase for the 0/S and YYk$pst>ase for ths 
product Sit uh%rm XX nn^l YY are ttii t«o character area 
designators for the 0/S and product set respectively. 

Listings of these coimon decks ^ollowf 
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CTIils d«ck itflnes constants for yse with KEYPai^TS. 

CDafine base kmpoint proo^dur® Idtntlfltrs for a«ch arti of ttie 0' 



CONST 








aiik$t>ase » 


ivyj 


CIi€ - 


1491 


bikSbise « 


i&^;# 


il5C - 


249} 


c t k$ bast * 


250* 


C25 -- 


2 99} 


CiikSbsst = 


300* 


C300 - 


349} 


dtskSbase « 


^^0, 


C3S0 - 


399} 


dmi^Slstss * 


^00 # 


£400 - 


549} 


fmkSbase = 


5t.O, 


C550 - 


599} 


1 Ol<$l3«SS = 


^00 f 


€600 - 


649} 


ifklbasa - 


o30p 


€65 - 


699} 


1 IkSbas® = 


100 p 


€700 - 


749} 


lnk$basa = 


750, 


€75 C - 


799} 


JukSbis a = 


BOO* 


€300 - 


849} 


IgkSbase = 


850, 


€850 - 


899} 


1 IkSbase * 


900, 


€90C - 


949} 


lokSfeas^ = 


950, 


€950 - 


999} 


ly|<$l>as« « 


1000, 


€1000 


- 1049} 


mIkSbast a 


1050^ 


€1050 


- 1099} 


fflfikSnon 1 tor.b^sa 


' 1100, €1100 - 1149} 


^iik$Jol53tse ^ 1150> €1150 - 1199} 


iisk$b«st « 


1£00, 


€1200 


- 1249} 


mtkSbase « 


12^i0, 


€12i0 


- 1299} 


ockSbase - 


1300* 


€1300 


- 1349} 


of k$ base - 


1330, 


€1350 


- 13 99} 


osk$bts« « 


1^00, 


€1400 


- 1449} 


pfkSbase * 


1300, 


€1500 


- 1549} 


pmkSfeast * 


ISOO, 


€16C0 


- 1699} 


rhkSbase = 


17i0* 


C1750 


- 1799} 


srkSfeise « 


li-iOO, 


€1800 


- 1819} 


stk$base « 


IS^O, 


€1850 


- 1899} 


tsikSfflon i tor 


•„base 


^ 1900, €1900 - 1949} 


tfikSJob.base = 1950, C1950 - 1999} 


jskSfBon i tof 


*^basa 


■= ail0§, IZmy - ^§4 9} 


jsk$Job_base = I 


050, €ICI50 - 2099} 


avkSbase = 


£1©0, 


€2100 


- 2149} 


sfkSbtss » 


21S0, 


€2150 


- 2199} 


lokSbase « 


ZZQQ, 


€2200 


~ 22491 


ri?5k$bast = 


2Z30f 


€2250 


- 2299} 


dfi?k$taoe_ba:se * 


2B00, €2300 - 2349} 


syk$job_basa » 2350, C^ 


1350 - 2399} 


?i!tkS assemb 1 


:y_l angyage^base = 4000,1 C4000 


OS assembly langytge 


4000 - 4095} 



- 4095} 
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E»0 Kii^^OIMT COMVfcNTIOHS AND SUID-^IIM;;S 
2.4.2 K^Y^II^IT IDS^iTIFIEk CC1H0N DSCKS 



To be sypp I I sd* 

2.%. 3 KSTPOINT OSFI^ITION CQHHOM DECKS 



each are? Mantlfied In OSDKiYD ^nd PSDKSfD should tiivs a 
ksypoint <lef|nltioft copiron deck to glye the exact keyoolfit codes 
ari'l ^at4 format as w«ll «s so^citi fMgs for th« data r«duction 
software. l"«ich area f^as a tno cfiaractar strhig which rder^tlfles 
it. ^or the prodyct set* this Is tha t^o character prcdyct 
id^ntl^ler as xJescrllsed In the SIS. The stan^Jard conventior? for 
A^-i^Inq 1/S ktypoint <faflrltion ^o^i^json dtcks is xxDKEY where nn is 
tha ti*io character area na.iie. The convention for those for the 
prodyct set Is xxOK>:YP In a sia^llar yeln* 

Th«' f ol I owl fjf 0/S ^^n4 Pfo?|yct set coniion deck listings show ho« 
these entries are set up. 

C PURPOSE! 

C This dack cootilns all of the set mnn^gnr keypoint constants. 

COHST 

CENTIY/EXIT CLASS KtTPOINTS > 
Cgated entry points for usersl 



s tk $ cr 9 at e_s et ^ st k$bas e + 1 ,* 

CI: ' stp$cra«te«s®t' 'ring 
CX VstpScreate.set ' •status 

stkSpyrge.set ~ stkSbase + 2.» 
Cfc 'stpspur ge_set» > 
CX 'stpSpyr ge.set » 'status 



» H > 



' 120 1 



stktadd.ffiepiher _yol„tc_set « stkSbtse + 3* 
CS » stpSadd.^flfiember^vol.to.set* > 
fK * stpSadd.mesuber^yor^to.sat' 'status ' 120 > 

stk$remoye_iie?nber.vol_f r os!_set « stk$b«s« + 4f 
CE VstpSreaiove^fflember^vo t^froia^set* > 
CX Vstp$rei!»oye_:!Befflber^yol_f rom^set* 'status » 120 > 

stk$change.access_to_set « stkSb^se -»■ 5# 

is ' stP$change^access.to.set* 'access » H20 > 
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^.4.3 K£y^3I<iT '^^FINITIO 



4M0 SUID21I^5S 
H COmQH dKKS 



Clnterfacas into ssts frois otiier fynctiona.! artas 1 
CcaHs froii device »anaie«tnt > 

CE 'stP$g«t^jol>s_scfatcfi,.yo lumps' 1 

CX *stp$iet_jobs_scratcii_yo1yflies« 'status ' 120 > 

stk$i#t.¥o Jyiias^ ln^set * stftSfoase ^ li» 

C£ ' stp$get.«volyn!SS_i n.set' •satlnit « H20 1 
CX 'stP$fet.,^¥^olyif!8s_ln.set « •. status • 120 > 

stk$g«t«¥0 |y«®s_by_s«t_ort^loal = stkSbase + I2# 
CE »stp$iet_y0l uiifs.bf^sat^ordf nal ♦ > 
CX «stpSget.yolypes«by«s«t_Qrdina M 'status » 120 > 

stk$a«t_¥0 1 umts^set.i^aiie « stkSfetse ^ IBf 

CE *stp$iet_vol ur«€s_s@t_naiia« 'vsn » A32 > 

CM 'stP$gtt_¥olyi€s_set.?iaiie' 'status ' 120 > 

sti<$ls«yolyiie_ln,.s«t - stkSbase + 14# 
CE » stp$l s^¥olup«^in^set » > 
CX « stP$ Is.voluiie.lo^set* 'status ' H20 > 

stkScli sl^_¥o|yiiis_act i ve = stkSfoist + 15* 

CS 'stp$cllsl««voS ypt^acti v^' 'tvtindx » HZO > 
CX »stP$dtsk_volyffe.act lye » 'status » 120 } 



stl«Sdl sk.vol yi^e^lnactl ve * stkSbass •»■ 16* 
CS ' stpSdisk^vol yrae^lr^icti ¥s' 'sstord 



> 



CX «stP$cllsk_yol yfl!e_l nacti ye» 'status ' 120 } 

Coal I, s from persjanant files > 

stkSgat.pf^root.sl i€ = stk$bast + IQ» 
CE »stP$iat.pf.root_s iza' 1 
CX »stP$get_pf_root.s Iza » 'status ' IZQ > 

stk$gst_pf_root = stkSbass * 21* 
CE ♦ stP$get_Pf_f oct • > 
CX «stp$get_pf_r oof 'statys ' IZ§ > 

stk$stora.pf,_root - stkSbase ♦ 22* 
CI: »stP$store.pf_fOot' > 
CX »stP$store,.pf.root' 'statys ' 120 > 

stk$puf gt^pf.root * stk$basa ♦ 23* 
CE 'stpSpur g8„pf_root' > 
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2.y K^YPIInIT CONVSMTIOMS AHC 01110^11^35 
£,4,i K£YI»1IMT DEFINITION CUnmH DECKS 



C)C «stP$pyf ge.pf^root' 'status * HZO 1 

stl<$ftt_stt«0i«n#r - stktbass ^ 24* 

CX •stpSgat_s«t._oii?ier'» status ' 120 > 

sti<$s8t_pf.look « stkSbise * ES# 
CS ' stpSset^pf.lock' > 
■it »stP$sat_pf.lock» »st.ttus • 120 > 

stkSol ttf^pf^l 0€l< = stkSbase + 26* 
C£ 'stpSci tar_pf..look» > 
CX »stp$cleaf_pf_lock» 'status » 120 > 

Coitl frofi Job ?Mntitmtnt> 

stk$set_tndl_Job - stk$l>ass + 27f 
CS *stP$sat_end_.Joto' > 
CX •stpSset^and. job* 'stttys ' 120 > 

Cotll dyrlog deailstart saqusr^ct > 

stl<$ If^l t ii I ize.sets « stkSbase ^ Z9» 
CS » s tP $ I r^ i 1 1 i 1 1 z t.s et s « > 

CX 'stpSloi tl al l2J««s«ts» 'status ' 12© > 

stkSgtt.actI ve_S€t_ list = stk$bass + 30* 

CS «stp$i«t„ictl y«_s«t_nst» 'set lis • lao > 

CX » stp$get_acti ve_s@t«.n st * 'nunistt • 120 > 

CUHUSUAL CLASS ke^olnts > 

stkScant^dni^stor e.set.ord « stkSbase* 

CU »€ant diiBp$stor€_a¥t.sat_of dlna M «a¥tlndx » H20 } 



COSBilG ktypaints > 

stk$set_e^cJus i v€^l ock « stkSbasef 
CD *set exciysiye access' > 

stk$€l €ar„0:3<cl ys i ve.lock « stkSbase + if 
CD 'clear exclysivs access* > 

stkSast.lf^dax^asslgrjed « stkSbtst •»• 2> 

CD 'active set table incfsx assigned' 'astlndx » H20 > 

stk$-ne **_job_accessl ng.set = stkSbase ■*• 3# 
CD '^Irst Pf access of stts i^lthlrs job' > 
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• . K<"*y^lir4T conventions AHO GUID.ill^3' 
*V.3 K^^^aiiT DlflNITlOfNi COHHO^ r>£CKS 



CD 'mel ludax asslined — ast Ir^daM ¥• 'statys » 120 1 
stkSpf _r0ot_si ze = stkSbase •♦• 51 

?? ^iUSH CLIST 1* OFF) 11 
To be suppHed. 
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2.0 Kcfpomi coNViHTions km Gmmiims 

2*S nm- KEYPOIMT DESCtlFTIOH' 



:*5 ii£«ll£IEOIiI.ifS£iI£IlQi 

<tn slyutf .«l«S€f ip tor^inpyt> * s « <keypol nt^cl iss„« I locit l©o_d«ck> 

C <def Ifil tioni_decl<> .••♦3 

<keypolf>t.cl ass^aH osat lor5.deQk> 81= <€ft3i! code and/or co0P€nts> 

t <€lsss,.lJ«st_i«f In! tloos> •«• 3 
<Ofbll coda a.f^il/or cop«8nts> 

<cl'tss^t>as«^def lui t ions> *?« <cl ass^bis««N> <spg> - <spc> <l3sst> 

<ol ass^feise^l d> 8J« osk$syst«i5^class I osk$proiyct_s«t_cl tss » 

osk$us«r.^cl ass t oskSpinf^control 

<spc> J J- <spao-e> C <spfce> •«• 1 Tone cr more} 

<l>asa> sj= <lntsi«r> 

<def Inl tl i3n_dack> « i= <c.l ass.^tf Ini tior»_deck> i 

<base_def I nit lQn_deck> J 

<ktypolnt_^ff ini t lon_iltck> 

<class.:d8f inltlon_deck> ti= C$S$ STAP!T KSYPQIMT CLASSES $$$> 

<cybll coda and/or coi»ants> 
£ <g1 ass^daf I n! tlons> •♦.1 
<cybll coda and/ or cofffnents> 

£$$$ SHD KSYPOIHT CLASS'^S $$$1 

<cl ass^dsf tnl ti ■ons> Jt* <keypo lr»t_€l:t,ss> <spc> » <spc> 

<cl ass.base^l d> <of f sat> 
C <k8ypoliit_cl'ass_i d> <cy!Bit commBnty 

<keypolnt_class> s«« <idantlfltr> 

<offs8t> SJ- + <spc> <lnteger> <dalimitef> 

<de ! I ml tar> M* * J | 

<kt ypol nt^cl ass_l d> SJ* <chafaot8r> 

<bast^def if)it ion_deck> tJ- 

C$$$ ST.4RT KEYPOIHT IDENTIFIER Bk$£S $$!> 

<cyt5n -coda ind/or cof«ro«nts> 

C <r ange.basa.daf Ini t ions> ••• 1 

<cybll coda and/or coJB!nents> 

C$$$ gH0 KEYPOINT IDEMTIFIE^ BASeS $$$> 

<range.^:ba se.def In 1 1 lons> ««» <k8ypol nt„^:base> <ds I Iml ter> 
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if.M KI^YPOIIT COMVtNFXQNS AND GUIDELIHSS 
2*> 3N|P K^.i^lim Pc%€Ul?TlQn 



<l3ass^ranie> 
<l<typol fit_b«se> 3i= <spc> <l3afe_ld> <spc> - <spc> <foasa> 
<feiS8_i «i> «s» <lc!entlfiif> 

<hi ili_basa> *s» <lnteger> 

<keypol et^d€f Inj t i on_dsc*<> s« = 

C$$S STMT l<£YI>OINT OiSCilPTIQMS $$S> 

<cybll code anij/or coiii^ents> 

[ <xxfSkey.d8ck> ••• 1 

<cybil coda and or coji^!Pents> 

€$$$ gflO KSYPOIHT DESCRIPTIONS $$$} 

<x,xdkt:¥..cieck> S"«= C <sybll «;ocls a!id/or C0:fliiB6nts> 3 

C <i<@.ypol nt^lf^f o> ••• 3 

<keyo0l nt^i rif o> 2ja <l<typol r»t^constant_nr^e> <deMiiiter> <aol> 

C <k€ypolnt_descrlptor> ••• 1 
C <bl ^nk I lf>8s> 1 

<k».ypol ;fit,_©onstint„I lnt> ?!» <ksypoliit_constant> <spc> « <spc> 

<-k8ypol nt..ba.s8> <spc> £ <offset> 1 <spq> 

<keypol nt«constant> ? i =: < Idant If iar> 

<ksypoi f»t_base> ss= < I dent I f ier> 

<ksypo} nt„«ltscr iptor> tJ= C <keypolnt_d83cr I ptor _ Ms t> 

r <spc> 3 £ > 3 <eol> 

<key poi nt,^descr ip tor.Hst> ti* <ksypol nt^cl ass_ jd > 

C <specl a l_case_code> 3 

C <spc> <sul>_ld_f i tld> 3 
<spc> <k«ypoint_l abe S> 
I <spc> <data^f iel d> 3 

<sPS€l al_c0se_code> ss* H 3 N J S * T 

CH * Htr* H = Hos* S = task Switch* and T = Trap) 

<syt>_id_f I «ld> si= <syfe«id_length> • <syb_ld.ffS3tch> 

<syb_i d_l angt h> J :=» <f if Id^l tngth> 
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.<sul5_ii_iiatcii>. •?= <siian.lnt@ger> 

<sian^l?iteger> is* 0..0 FFFFFFrFFfFFF(16l 

<keypol r!t„l abel> *s= <lab-3l> 

<lal?®l> 12- » <cliar acttr«.strini> » 

<€Ntr «ot«f «str lni> si» C <«lplitbst> ••• 1 izmo or fflort) 

<data^fl8td> 25= <dita..label> C <spi:> <dlati«f i tid«d®scr i Ptor> J 

<dat3_i at>8l > 11= <labal> 

<dltta_f I al d^descr I ptor> Js« <cliit3_fof i!iat> C <data«f i eld.l engtf»> 1 

<citta_f or3iat> ss= A I H J I 

ik - A Iphatiyfflar lc» H » Hex* I « Int«g®r) 

<data.f lei d_l ef>gtfi> 5«« <f i 6ld_length> 

NOTfcJ <syl3.ld_lenith> •♦- <data.f i al d.length> must be <= 52 bits ) 

Opsritlng systffB <ktypolnt_<:i ass.l d> = CD*E>ll»X>) 

<kS3<pol nt„cl ass^i d> for tny ksypolr^t usad for udditiontl 
I nf or fnat Ion to previous keypolnts must be a space) 

A <d8f I nltl on.dack> ranains In effect until superceeded by 

1 deck wlilch radafines tfie arsa to wlilcN it partilns) 
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3.0 NQS/VE KiYPOINT COHHANDS 



3.0 MQ50E«S>fIEaiiI-£aiiM2S 

There Br^ three NQS/Vi commands supplied to coritrol kei^polnt 
processing tod to issyt sptclflc l^sypoints at a con^tnd level* 
These coiinefKds are also defined in the Helpful Hints docuwent fQr 
tilt currsrit oycit of MOS/¥£» 
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3.1 £aiIlflL,£Oii!iiM 



Ttitss tHo sopfnands coi^troi th® setting of tlit Keypoint m&sks in 
the Job ai^d ^onitar mode exchange packages and tfia type of 



3«1»1 ACTI¥ATi.K€YPOIMT 



Ttis act I ¥ite_ktyp®i nt comiiiancl Cabbrsv lated actkl irjitiates 
kaypoint rtcors^ing tnd colltotiof^. Tills Is don« directly for 
soft'^ara HeypQlnt collection but hardwars collection aisc 
rsqyifts tilt 1?0 stit« kmypoint collsction program CPKPHOS to bn 
Initiated* 

The parameters for the actk comflu tnd are as fcllov«s» 

HiXiOia i£i£EI£IIQM tMUg QE^^ 



licdft 


m 


«oy| ron^ent 


■e 


fiorsi tor.fiask 


mm 


lob^mBsk 


M 


st ar t^cl ass 


start 


stop.c;! ass 


stop 


keyool nt^f 1 Is 


Hf 



col faction 

10 de 

recording 
any I ronment 

II st of 

Integers 

list of 
Integers 

Integer 
Integer 



naiTse of file 
for software 
GO I lection 



col rector. buffer Integer 

_s I z e 

cl»s 



s f t M i r e J s J h «r dm mr b I f? 
jobi j J systefflls 

Oil? ••Ui 
file name 

ICI0O. •1000011 



pirtiettr 
requ I rB6 

paraieter 
r^Bqu I red 



CC*,15> 



15 






ICICIOC 
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3*1.1 ACTJ^/ATC^KcYPOrNT 



col I «etQr.cl«lty delay ptrlod 10«.iOOOOO 

cd } n Hi 11 Iseconds 



50 



3.1.2 iEACTIV^TS^KiYPOIWT 



Trie deac tl vat««kef po ifjt comm-^nd Cafebr8¥iat«d deakl Is usee to 
tariif^ate the Issylrig of keypolnts b^ clearing ttie kafpolpt nasks 
Iri tlie J0l5 and ?«or$ltof iiods axohtnge paokagts an«i tocilni softnart 



^ilMflill 



aiSCilEIiOi 



tAim 



MEillil 






rt cor ding 
envi rofifflemt 



joblj I systeiPtS 



job 
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.3 ^OS/VH K3YP0IHT COMMANDS 
• i KiYPOI^T ISS'JB COMHAMDS 






Tli« a^lt^ktf point ooiiisand Cabfer ev latedl tislkl Is use4 to Issue a 
keypolut at ttit SCL is^el* Its m%ln yst Is to Issua eiiss 15 
keypolrsts to start an^di stop keypolnt collsctio^fi ryns. 



M.tmm aESHEiEimi 



life 



iifiyii 



diss k«ypolrit class 

code kaypoint code 



OMU.IIS 
§tlU.lf=FFFFFFPC16) 
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%*■§ PUP SOFTiAtS 0¥gl^¥X£1 



%.o Ea£-iaEIM4&I-.ai£EIIIM 



The i§0 sarles iaelilr?es iiafe a perforwince siofiltoflng facility 
iPHf) built into ths fitrdMira* ¥arloys types of data.tra liidt 
aval labia for ponitortng systtsi perf^rmBinc&* This Introdyctlon 
mHI not dtai Mlth tht details of nhat Is awaMable cr the 
details of h^w to solltct ttit iatt» 

The eoriectlori Is initiated fron the system consols for systens 
Mt^lofsf tt this tiaia* art rynrjlng in dyal state* Keypoint 
liistruct Ions ha^t b«tn Instrttcl «t ttit gsttd ti^trlts and tMlts of 
siiolflstnt procefjyres In the oparatlng system (OS) and product 
sat CI^SI. Tti€fs giay also be other ktypoiots InsertttI for dati 
collection or otiier pyrposes* In additlor?* s osts processor stft« 
^tti Is iVillilsIt* This wstr gyicft Is directed towards the users 
of the ktif point data* 

The H^fp^int data lyst be analyzed to obtain ysefyl Infer fPtt Ion . 
TH% stt of progrtffis In this user gylde Is directed toward 
dessrlbln§ tfi© tools tvillabls to analysts for tr tnsf or f«lns data 
Into Inforiiatlon* 

Tht Kaypolnt collection is done ffop the operator console while 

NOSVE Is rynning the Jofolsl to be intlyzed* Th€ oytpyt is the 

raM keypolnts data flla <KPTS)» This Is ryn each tipe a jobCs) 
Is to bB sn«lyz«d» 

The fono*«lni Is an example of tiia logical sequence and 
interest Ion of pro^raiPS and datat 

Oati CoMtctlon - — ~> ra^-data 

K?PK't — «> prsprocss-dtta 

J-- > KPREO — > rtport(s) 

KPPm ™> KPPRE —I 

• «.«> KPTRUH > raport 



J— > KPQRY --«> <iyeries 



raw-data • — * 

pr e pro CSS -data — S 
rai«-data ^ > KPCHl - — > report 



The overall process is shown In figyre 1 
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4.0 PWF SOFTMAii 0¥£t¥IEII 
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4»0 PMF SQFTIIARE 0¥iR¥Ii« 



KP*4^ Is ryn to produce the PA^Sc **M8. This proeass modifies 
th« ki»ypolf>t data on the conrpon dacHs Ir^to a fom syl table for 
tne pr^ofo'^sssof <K?Pi^gl» This process Is rsr-yn only if tilt 
com^o'% d^cks are chan9€«^« THe outpyt* PARSFl nay be ussd by all 
of tHe ^N- users. 

KPPiE transforms tt?@ raw d«ta- Into a ©onison fonitt for th.% 
sybssqyant analysis programs. It can do some editing of tfie file 
ysini tn^ i!lrectl¥«s froi^ the KLIIQ file* It CMn also select 
portions of the raM data fll« ysing tt«« start CSTPI tnrf stop 
CSTP> dlrtctives In the parameter Input. The oytpyt froiB the 
preprocessor ire ttia preproeesstd key point filt.> tht cJtscriptor 
file a^nd several reports* 



KPQRY allocs scanning of eltlier the raw keypoints data 
the pTBpr QQessB^ data flla to iletarmine some of the 4 
keypoint files* This Is Intended to lake quick* ad ^*'* 
aliOijt tht natura of tht ktypolnts. 



data flic or 

a ta In t'he 

hoc Inquiries 



KPiRis) uses the d tt i froii the cftsorlptor file and t.he or eproctss eel 
keypolnts to pake morB extensive* but predeflnedt reports of the 
aonttnts of tht k«ypolnt ryns* 



KPTR 
from 
e)ctc 
CY8I 
kayp 
re la 

f5#f1IO, 

netw 
Inte 
ktyp 
CQHS 
keyp 
oytp 
a fi 

PBtB 

asci 

onct 
save 
proc 

rtpo 
para 
Fi na 

QOWib 

or I r» 



m I 

gat 
ytio 
I pr 
I n t 
t ion 
ry r 
orks 
r ^ed 

I n t 
IH£ 
olnt 
y ts 
le I 
mate 

1 fo 
fo 

r a I 
ess I 
r t s • 
iiete 
I ly* 
Ined 
ting 



s a 
ed k 
n t 

og fa 

f 

sh I p 

a^yl 

are 

late 

s ■ f r 

pro 

s 1*1 

the 
n f s 
r . 

f ?iat 
r M 
diff 
ng 

Th 
rs s 

the 
c 



pr oces 
eypoln 
Ifses w 
us an 
He 

s that 

resient 

are d 

file 

Offl the 

th the 
se rec 
cl I f 

fcich 
. The 
ny gl 
er ent 
to St 
e Inte 
peci f I 

PRINT 
al I er- 
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ts 
it 
d 
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s 

Ufi 

'• 

I 

T 

s 

or 

or 

re 
P 
ve 
so 
ar 
rm 
ed 
p 



(Fli 
. I 
hin 



X i s t 

I M > 

The 
nttr 
he C 

ds t 
jiat 
cord 
roce 
n k 
rt 
t at 
edi t 

to 
roce 
I lee 



. Z 
t re 
etch 
sort 
tou 1 1 

on 

and 
per I 

sor 
ytl 
OHBI 
pare 
oget 

on 

con 
ssl n 
aypo 
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thi 

t« f 

orde 

ss r 

r 



) for 

const 

p -a c e 

s« 

ds 

the 
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s* th 
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antlyz 
ructs t 

d keypo 

the n 

key pol 
e r e a s e 
I ly <ey 
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ograf» s 
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file 
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nt for 
s now s 

record 
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s Int 



Ing 
he s 
Int. 
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etwo 
nt 

the 
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ipply 
th-er 
yffls 
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k ey 
spec 
nt a 
Int 
If r 
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the 
or te 
s fo 
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r 



the en 
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file. 
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eports 
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d file 
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tries 
o dete 
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e pre 
call 
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input 
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descr I 
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5.0 P«F SOFTWARE imikllAlWt 



* £i£«ia£IMiai«liSI4LLIIIfli 



HATSilALS 



PHfPL 

pnfCQn 

XULIB - 



Alii any local aods to PMFCQR* t ti€ file contaloing stiangts to tl^e 
PHF programs* 

Add the folloHlog statasitnts to the PROFILE file* 

\ PUS* «PI1FPII8» 

\ T00LLIB*»XUII8« 

\ TOOIACT* the f^HF yser naiieHe** •KETPERF* 

\ SEARCH = iPfifPllBfthe PHf ussr naipe) 

Aftar PHFPL* PHFCQR amiJ mJllS have b«an loaded do 

SHS.AHHCl^P PHFIMST C^PHFCOR S^PHFFL 
. 5=3.g^?P?OC S'COHPIIE B'PMFPLli 

SiS.P^FIHST ALL 



The ctlls to GSNCO^P md REPPf^oC oaad only fe« clone i«heri th-% PflF 
prograips are bslfig Installed for the first tifi^e. Frosi then on* 
only PHFINST nteds to be otiitd to Install tt?e particwlar raodylss 
iihich are to be altered. 
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5.1 P^FI'^S^ 



5.1 £i£lill 



This procedure Installs the various components of the PHf sustain* 
It installs th^ objact coda on ^ library filtf and tht SiS 
proc^iur^s on a PLVi file. Prior to Installation « filet PMFPi# 

oontslnl^.j the yjfious ^o^ylas 'nust exist in the Installation 
user nu?i*i^r (UH)» A second flfe^ PtIFCOR* containing the 
correction set !?iyst ^Iso tee avallabla* The PROFILE of the yser 
^nyst <?f?nti^in th^ tJtf ini tlons §l¥tn ttjovs. 

Anv of the 0^r dim^t^r s deflntd In tht SES fflodylt JQB^^^fl ^ay ht 
ysed. These Inclyds JOSTL* JQSFlf J08CH* JQ8PR, JOSUN* JG8f>y» 
JQIF^LY* J:HC^* aOSP*^* local* SATCHH* BATCH* mfmp nOOi^YF* 
DAfFXL^f A'^O OF. CSe€ SfS Frooadyre Writer's GuldSf Appendix Al 

Installation ParanetersJ 

CALLAM Install tht object for the call analysis portion of 

CQ^Bl^i? Install the object code for the prograai which confelnes 
th# Inttfiitdi its sigmtnts produced by CALLAN CPtrt of 

KPimm . 

PRINT Install the object coda for the routine which prints the 

RSPO^Tis) CPirt of Kprmm 



CPK^HOS Installs tha 
routines. 



CPU portion of the data coHection 



PPKPHaS Installs the ?9 portion of the data collection routines. 

KPPRi Install the ohject co^de for the Preprocessor. 

KPP4R Install the ofeject code for the keypolnt descriptions 

parser program. 

KPRSD Install the object code for the primary data redyctlon 

pr oir tfflt 

KPQ^.y Install the object code for the KPQRY program. 

KPCNT Install the object code for the KPCNT pr ograii?. 

All of the above progranis btb stored on the file XULIS. 

PRPliF Instill the SBS proc for running the Iceypoint 



Instil I the 
collection. 



Control Data Private 



Ptrfantr^ct Reporting Faslllty EtS 



5.3 PnflHST 



3"^ 

24 Fib 84 



PRK^^Ri Install the SSS proc for running KPPRE. 

PRKPfAR Install the SgS proc for rynnlof KPPAR, 

PRKPRcD Instill tht SSS proc for rynnii^g KPREQ* 

mKPQm Instill ths SES proo fi^f rynninf KPmr* 

mK^Cm Ir^sttll tht SiS proc for running KPCi^T. 

KPJRiSH Install tiie SSS proc for running the sill «r?tl¥sls 
progfins. 

PHfinSl InstnU tti6 SiS pros for Installing tli€ installation 
progrsffl. This mIII ysually fee done only when .the 
I nstil lition progr ti? h«s fotsn aiocSlfltd In f*HFCOR« 



All 



Calls for Installation of ail of tlis atsoYe programs an^ 
procedures* 



The abo¥« proc«dyfts trs Install ad on the SES proc library* 

PLC This paraiietsr Is used to change the n^m^ of systeii? CPt_* 

If It is yndtr i dlfftr«nt niing. 

ID This paraiattr Is ysed to specify tht account Mhere PLC 

resides* If different than LISRAHY. 

Afttr FHf=INST has completed batch execution* all b\nB.rles Bre 
found In XULIS* and all outputs are found in LIST, The P? dita 

collection prograis Is under the nasis PHf* The sequence of 
cosi!i«nds necessary to p I tee tht code In the system Iss 

SSS.fiETHEH ?Hf PP B^XULIB 

SyS£DIT*8 = GR0UI>. 

These comaiands wust foe entered frojn the system console. 
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♦ 2 £Sflaa4i-.B4IiI£i4lli;£ 



Ai I 

an?! 
TN i s 

tr ® 
til at 

■00 rr 

irou 

dafa 
Into 



t « I f> « 
proced 

f I It 

so lit 

act I on 

OR 10 

addl tl 

y It CO 

tl^» s 



fated iiat 
n oriltr I f 
yrsS:» al I 

4 In th'B c 

sites M 

or op«riti 

ID for 
g«s %r% of 
♦ Presaiit 
ding used 
t>n f It 9 
nd It ions 
I te local 



erial Is stored on PHfPL* In order t 

systiw of QhMn§in§ or eorrscting the program 

changes trs entered Into a ©orraction file 

areas for antaring ciianges* Senaral charige 

orrtctlon ID €il!td PHFCOR* It Is rtcognrit 

ill Nave spacial need to cater to ttie! 

cnti procedyrts* Accordingly ttiers Is 

site local modifications to l^e stored* I 

■itnerti us«.f then thty way be fflovsd Into tti 

ly,# tha site local ctianies rtfl«ct tht ysa o 

on tape sqy|p?isent rather than phase encoding 

ay fee dtslrtfele for soise slt«s to chtngf th 

n some of the orocs and these i^ay also g 

n?ods« 



There tr® tuo «tthods of gansrtting the corrections* One Is to 
gat the nodule frow PHFPl applying the PHFCOt changes^ and then 
chmglng tht rtsylttnt nodylt to fix the bu§ or introdyce the 
change* Then after testing^ m-BkB an SES SiNCOR run to produce 
tht chiHiss r«<|y}riid to go. Into PMFCOt* Tha oth#r ^ty Is to iiake 
a GENCOMP run with the SSQ pBrnmBtBt to get the line numfctrs# 
thti. anttr the pfopmr Insert and delate entries In PHFCOR* 
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.§ PWF DATA COILECTION (P?KPMOS> CPKPNOSI 



6. S.a£«a4Ii-.£fliLi£Iim-i££E£iflSi«CI£EEiaJi 



Tht PMF lilts ^olltetlofi prQ§rwM ^ts sifltttrj to provide t stains 
for tfie csollectloi^ of data frois ttie CYSSR 180 Performance 
Hon! tor I Hi Facility {PHF)» IhB progrtsi ys«s tlit PHF hardMare to 
collect I nf 0rfflat I on on program axecytlo-n and to collect virlous 
iiaslilne stttlstlos. 

Fy 1 1 ysa of thB ?Hf liarci*«ars is possil?lt Mlth tlis progrii!?* Ir? 
addition* the program provides ksypolot selection options an<l the 
ijapiisllity fQT til® pariodlc stppllni of k#ypoJnts# 

Tlis PMF data ooHtstlon proprtJi Is written in P? CQHFASS tod runs 
wndsr ttia A170 NOS operating system. The program nlU fynction 
on sithtr s strictly A17C lodt fiiicliln® or on tht 170 slda of t 
duat stata niacliine. iitille rynning on the 170 side of a dual 
state ^aclilnef the proprae can oolleot Information aboyt both the 
A170 and the 180 si dts Cthroygh both, the counttr «nd ktypoint 
ntchinlsis for 3.8§ state). A170 state collection Is limited to 
coynttr data* 

This docyffient assyiies that th t rtadar Is ftwillar with th« Cf8£R 
180 P#rfori?ance Honltoring Facility and CY8ER 17y COMPASS, 
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6.t PHF OATIi COliiCTIOH Cf>PKI»NOS# CPKPNQS) 
6*1 PROSRAH COI^TROL km COHWNICATION 



6 . 1 ^mmm.^mMMQUiM^.£mmMi^kiim 



The program uses several areas in ce?itral m%mQry as cGiaynicstlQn 
if«as* Tii«s« tr««s «ra shown In figyr« 1* 
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FIgyrt 1 

Prograni PHF Is initiated by a RA+-1 call >«hic^ cor^tains In its 
lower 18 bits the address of the parameter block* This block 

contains the keypoint salactlon tnd stiipllng par i»nat«rs.f t 
pointer to the register 22 folock;^ and, a pointer to a File 

fcnvl ronrufrn t labia (F€T)» Tha FET In turn describes a circular 
buffer Into which this keypolnts ara collectatl. 
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6.§ fMF DATA COlitCTIQN iPPKPNOS^ CPK^HOS) 
§•2 f*R09i?AH PPKmm 



6.2 EiSaMi-££E£ifli . 
6. 2. a mill^LIIATim 



TN« proiraw PHF Is loaded into a PP in response to a RA+l call* 
Qnss inltiattdf It MiH li^sure that ttia CPU Is s CYSiR 170 Pisdtl 
825» 835f or 855 Mn4 that the PHF hardware option Is Installed* 
If tht progrnm dtttots toy ottitr copIss of PHF rynnloi* It will 
abort the caning pfograff. and then drops out* 

If no ottiar coplas of PW are running^ the program nMI read tfie 
sa¥an word ptr«isst«r block polntsd to by tha lowar 18 felts Of tht 
R4+1 cail» The address of tlie rsiister 22 block is than cheoksd 
to Insyft that th« folocic lias ulthin tha ysars field lengtli* 

If the keypoint €Oll«otlon flag Is not s®t In uQrd ti^o of tht 

parasRster block* Pf^F will Ignore ths remainder of tha block* 

Tills enahl«s tha yser to oial t tiie FET ind circular tjyfftr If 

keypolnt col I act I on Is r^ot desired* 

?Hf then checks the origin type of tht calling program* If an 
I nttr active progrtin has rs<iytst^d keypoint collection* It *«lll fos 
aborted with an error fflessags* CKeyoolnts way not be collected 
Inter ict Ivtiy is tha CP prouf^^ must l5« locktd Into CH for the 
duration of the collection period*) It Is possible for register 
£2 to ht loaded B.r^4 dypped Interactively for counter ?iode 
collection only* 



6*2.2 LOAOIMS Am QUHPim RiGISTSR ZZ 



To stirt tha PHF hardMire* register ZZ must be loaded with 48 
bytes of data* This initi allies the hardi^ire and begins PHF 
operation as specified by the control fields In tha data* To 
stop PHF hardware optratlon snd to collect the eight 3^-blt event 
counters contained in register ZZ* the register iiust be read and 
dy?i?ped to C?1* 

4fter In I tial Izitl on* the program PW daterisinas from the 
paranetar block whether register ZZ should be loaded or dumped* 

If the user has selected loading* the area In CM designated bs 
the register ZZ block Is read and Its contents transferred to tht 
PHF HBtdw^r^m If dumping -l b selected* PHf Is stopped Bnt^ th 
contents of register 22 are transferred back to the register 
bl ock In CH« 



e 

22 
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6»§ I^HF BATk COLLECTION iPPHPHUSf Ci^KPNOSI 



If kaypoint goI lection Is n^t required* ths program PH¥ will 
rastift Its ctHlr^i progrtii tr^d drop oyt after loi^Ing rtgistsr 
22, Tftis psriBits tfit ustr to initialize ?H¥ and to collsot iati 
In tilt coynters MJtlioyt lit¥ini tha progrtm PHF runnlog at th% 
saiT?e tl?ia» When thB test Is eo«pltt«# tht ystr tfian eiils PWF to 
4ump the contents of register EE to Clf« 

Afttr a dump of raiist«r 22* tl^a program PHF always rastarts tlie 
caning program tn^ drops* 



.2.3 KSYPOIMT COLl£CTIO« 



Aftar lotdlng register ZZf ths yser may liave the program PHF 

remain In the PP to collsot kaypolnts. Mfian collictins 

kaypolnts* the program enters, b loop whlcl^ consists of the 
foi I owing sttpss 

X. T8st for any condition tfiat re<iuir«s tlie progrtjn ?W to 
stop. This Inclydss a PHF harcli#are stop* an error In th€ 
€P proiriiij in optrttor cirop^ or tha optritor CQmm»n^ 
*'n.CFO*STQP.»». If the condition Is not fatal to the CP 

progrtfi* taripination proctssing Is begun. 

Z* Read kaypolnts from ths PH? FIFO tjufftr to the stitction 
buffer In the PP. If a sampling Interval has been given In 
tli€ paraifjatsrs* on* keypoint Is read after each Intervsl. 

3. Select keypolnts froii? tht selection byffar ^nd plact the?p 
Into the keypoint feyffer. Selection Is based ypon the 
kaypoint selection mask ilven In the paraweters. The yser 
iiay also collect every nth keypoint of any given class 
iccording to the keypoint selection counts is^B sactlon 
4.11. 



yrita keypolnts frcjp the keypoint feyffer to the circular 
buffer In cantral saemory. 



4. 



The CPU program may read the keypolnts directly from the circular 
buffer or mBy periodically Issue CIO re^iuests to e?RPty the buffer 
to a file. 

The keypolnts are placed Into a circular buffer with one 8-bit 
byta per 1.3*blt PP parcel. The upper four bits of each parcel 
sre set to zero. Since each keypoint Is eight bytes in length* i 
keypoint i^ I i i occupy, one and three-fifths CH words in the buffer. 

EMactiy forty keypoints will fit Into a single PRU. 
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6.§ PHf PAT 
6.2*4 Em P 



A COLlfiCTION iPPKPnmp CPKPHOS) 

mtBSSim 



6,2.4 i>IO PRQCSSSINC 



tod processlf^g cofislsts of dyiiplfig tlis Itst k#ypolnts colltcted 
to the circylar foyffer* aod dy^plog tiit C0rjtarits of register 22 
to tii€ reflsttr 22 fotock. 



Keypoff^ts are transfarrsd frotfi tlit PP feyff«r to tht circular 
buffer on a PRUbasIs, yisen cotlactlon Is complBt^f 8 bytes lone 

keypointi of ones are addad aftar tl^t last keypoint if tlitre is 
rjot exactly one PRU of ksypoir^ts left In the ?P buffer* This 
tntblts tha ustr to dtt^f^lne hom istny keypolots In tht I «st PRU 
are valid and s^rv^s as a dalifultar* 



After dumping the k€ypolnts# the PHF hardware Is stopped and the 
^onttfJts of rtglst«r Z2 Is plac#i Into th€ register ZZ block in 
Cf1» 8lt Z*^U of byt€ of raglster ZZ Is set to one ^hen the 
raglster Is tfumptcl to CH« Tliis bit Is checked during keypoint 

collection to determine If PHf operation has stQP^Bd* 
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6.§ PMF DATA COlliCTIOH CFFKPMOS* Ci^KPNOSI 

6*3 cmnmickTWH slocks 



6.3 QUmmiLilUU^lLULt^ 



'li« Pififitttr block Is s«¥en CH »ords in langtti. 
>saydo-COHI^ASS iltsoribts Its formits 



Ttie f <s I IomI H: 



l>ARilK ¥F0 l/Load^OufflP^Flag 

¥FD 41/0 (reserved for future use) 

VFD 18/RBg2a^8look_Adi3r«ss 

PARSLK+1 ¥FD l/Keypo I nt.CQ I I ect I ori«l= I ti 

¥FD l/Keypolnt_$aii|>le_Fl ag 

¥F0 I./Ktfpoint_S®i sction.FIti 

Vrl) l/Central_Heiiorr-PHF_8yf f sr 

VFD 4/0 (r#serv«<S) 

¥FD 16/K«fpoiot_5s1ect40ii.Masl< 

¥FD 12/Ktypoint_Stinpl t.Ifiter^ai 

¥F0 6/0 Creservad) 

¥FD IS/FET^Address 

PARSIK^-^ ¥F0 12/Seltctlof»_Coynt_0 



¥FD 



PAR8LK4-6 ¥1 



12/S«lectlon_Coynt.l5 
4 8/0 <rts«rved) 



6C/0 



t reservad) 
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5 5 4 3 2. 1 

9876543 21 098T6543 21 098 ?6f432l098Tft5%3ai 098765432109876543210 
^^ — «-- .« -.-«^-«.-.^— .««^,-«.«, «-.^««-.«-. — , — «.+«-.«-«.—«-. «.-. + 

tl kesBf^^d I Reg .22 address » 

linoOOOl Kfst sti liisk ISasipIs int.l§Q©0©l FET address I 



I sal «tr I SBi €tf 1 * sel ctr 2 I sel ctr 



t ctr 4 5 



s©l ctr 



» s e i ctr 



* St I etr ? I sal ctr 8 



isel ctr 10 isel ctr 11 «sel ctr 12 Isel ctr 13 



sel ctr 14 I 



IstI ' t^tr 15 I 



aservsd 



Rms^f^^4 



Note ttiat tlie selection count paraiietars occypy *<ords PkU.BLK-^Z 
through PAR81K+5, 



Xh% pirtfflttsrs artJ 
Load^Puinp.^F I ag 



Rei22_3lock..Addlr©ss 



If sat to 1* Indicates that register 
22 should foe loaded frc^i the 
rtgl'ster ZZ block. If s«t tc Of 
Indicates that the contents of 
register ZZ should be dumped to t^t 
register ZZ block In CH« 

CH address of the register ZZ blcck# 



Kaypo Int^Collec tl on„Flag Sat to 1 If the user desires the 

prograw ?Hf to regnal n In the PP and 
CO I I ect key points. 



<sypo lnt_Sas!pla_FJig 



If set to 1 the program ^t 11 read a 
single kaypcint frop tht hardwart at 
intervals specified by the 

Keypolnt^SafflPle.Intervai • 

Otherwise* all the key points are 

r IS i d • 
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Kaypalnt^Select ioir^^FI t! 



C«r>tr »l _M««ory_PHF^8yrf tr 



Keypolnt..Ss iact ion.Hask 



< t,Yp0 in t^S^mp\-B^l r^ter ¥«l 
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If sat Jndloate that the Ctntral 
Hsmory PMF FIFO h-yffer wHI be ustd 
Instead of the hard*iare FIFO buffer. 
Th« CH ■ byfftr Is ont pagt long 
versus the 16 words of the hardHtre 
FIFO Ijyffar. This hyffar Is driven 
dlractly by tht micro coda. 

This siask deterflilnss which cl ass ts 
of kaypolnts are coilectedf and 
which classes trt dlsctrdtd (s®e tht 
description of the 

Ksypolnt.SsI actlon^F I ag) • The 

leftmost bit In this wasH 

corresponds to kty point class 0> tht 
rightmost bit to kaypoint class 15. 

In ful M I seconds* the ifjount of time 
to wait between the coil set I on of 
keypolnts Csee the 

Ksypoi nt.Sanipl«_FI agl • 



ST^a- 



r ess 



Tht CH addrass of 
key point collection. 



the FiT 



for 



Control Data Private 



Perform^ncB Reporting facility £RS 



6«a Pm QMA COLl€CTIQN ifPKmQSf CPKPNOSI 
6,3a PAtAMiTlt SLOCK 



6-9 
24 r€b 84 



S«l «otl on^Coynt^n 



For a vtlyt is# avtry ntli kmypolnt of 
class n Is collected <©*§• If 
S«t tctlon^Coyf^t^T l^as a val ye of 5# 
every 5tli keyfsoint sf ciiss 7 mUt 
h& eoMtcttdl. If « filii® of or 1 
Is sped fiedf all keypolnts of that 
class Hill fee collected* 
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6«CI PHF^ OATil COiliCTIQN IPFKPI^OSf CPKPHOSI 
6*3.2 tfcGISTEt- 22 BLOCK 



6* 3,2 I^SSISTiR ZZ BLOCK 



Tills bloctt Is tli« l»i«it of r«ilst#f 22 as It is rttd or written 
from tfi8 PMF hardwire. Raglstsr ZZ cor^slsts of 48 aight bit 
i>ytss» To simplify tt^a 1n%n4iln§ of ti^«sa bytes^ tfity irt Itft 
ynpacked In the register 22 foiock? one byta In eyery 12 felt 
Pirctl t> f a C^ iiord. ytitn lotdlng rtglstar 22.* tlit ypp«r 4 foits 
of sacfi parcel Is Ignored* and ^hen dyiiplrjg the rtglsttr tli« 
ypper 4 bits -Sir % sat to zero* 

Tilt folloMini C'3^P^SS com mIH itf^trata tli# rtglsttr 22 blocki 



VFD 



12/iyta,0 
12/Byta_l 



^FD 



12/Bytt.4? 
24/t 8S erve* 



5 5 4 3 2 10 

98T6543 21 0^87654321 C987654321O98765432i09876§432iO9876i4321C 
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Note that tfie register Z2 block occupies 10 CH words^ with the 

loMer 2. pirceis In the last word being reserved for future use* 
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.§ PHF DATA COLliCTIQH CPPKPHOS* CPKPMOS) 
.S*2 l^gGlSTgl^ 2Z SLOCK 






itscrlption of #tcl? fcyte 



3.3 FST AND CltCULM SUFrEi 



The F£T af^d clrcultr feyffer us#^ for ktypoirit colltotion iff 
idefitlcil to those usad whan parfonning iioriial I/O transfsrs* 
Tt^ay iBay tie created ysing tlia fol lowing €OMI*ASS ?iiacros« 



SUFI 

FET 

8tlFF 



FILiS 
8SS 



8UFF>8UFt 
BUFL 



The 
tr tils 
progr 
\%mt 
this 
byff 8 

part I 
kaypo 
l3yff e 



ksypo 
f«rs 
aii a 

rtst 
r oiay 

usar 
cyl ar 
lr?ts 
r» 



If^t collection prcgraii ^^as v^rittan to provide fast 
of ktypolnts to tfi« CH byfftr. To ftcllitatt tliis^ the 
ssumes that the CH buffer is always <n * 1008) worcs in 



©ft n >- 3J* If the buffer length 
fiction^ ktypoifits miy bt lost tridi 

be destroyed* The P.P will never 

»s fiel^ length. The opti^yn 

application will depend upon 



does not conform, to 
data In or «ft€f th^ 
yr rte data ■ outside 
buffer size for a 
the rate at which 



are lssu#d tnd the tiount of tl?iie n%%dB^ to empty the 



It Is the responsibility of the CP progrts! to _ Insure that the 
huff«r Is taptled. The progrtw m%y do this fey perlodlciMy 
Issuing a CIO write request* Alternately* the program pay read 
the ktypolnts dlrtctly out of the huffer and process them as they 
are being collected.. If the tP progr tffl Is to read the keypolnts 
out of the buffer* It pust read only iat^jS^L-lMltillSS of ^ ^^^ 
at a tine. 

If keypolnts art being Issued at too great* a rate the circular 
buffer fflay heoone full. If this buffer is not ejnptied before the 
P? transfers the next PRU of keypolnts* all the keypolnts In the 

CN buffer mI 1 1 be lost. Special checks are mM4% In the datt 
collection software to detect such data loss and to flag Its 
occurrence* 



Control Dtti Private 



'€ffOfitnce Reporting Facility SRS 



6-12 
24 Fib 84 



6,« PMh: data COlliCflQN IM^KPMOSf CPKPNOS) 

6.4 pmmm cpkfnqs 



6.% £EIISMa«II£li£ifli 



Tht profram CI*KPMOS liis fetsn «rltt«f5 to provide tht yser witti i 
weans to collect countnr arsfJ/cr keypolnt data froii the FMF 
fiard^art. CPKPHOS* i^lilcli Is urittBn in FORTRAN 3 ar^^ CmPASS* 
yses thB PP progrMm PH¥ to ratd and Mrlte register ZZ* thf PUF 
loantrsl rtglstar. It th^n prodycss a listing iifilch contains 
t^ardnare afi<l software statistics* 



IS Is? 



The defaylt Inf^raatlon provided by CPKi 

!• Central H^mory Reads 

2« Caclit Hisses 

3. Cache Hit Rate 

%« Cantril H^mory Wrltts 

5. Total Haaiory ^ccassas 

6. Instryctlons fKScyted 

7. Ryn Tliia 
3. HIPS Rits 

9. Transfers to 18© Sttte 

10. Tl?^e In li§ Stats 

11. Ptrctnti§« of llm% In 180 Statu 

In order to give ttie user additional control ovtr th-B control 

f I al ds In PHf register ZZf a set of parameter keywords Br e 
provldad. Th«s« tisc if low th# ustr to d«f|n# tN« start and stop 
tlfses for the PUF collactlon parlod. The followlof pages 
suraiuiriis the different control parasistars for ttit data 
collection program. 
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6. 4,1 CONTROL P^^Amti^S 
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to.4«x CJ'^T^^'^l PA^A^iTgRS 



All control pirawettfs titf be sptcifltd ejthsr bf their full 
names or by a oos tc three eliartcter abbreviation* In tti# 
foil Qwin§ dtscf ipt I «ns* t*it t^tsf t¥i «t lor^ Is sli^Mn dlrtctlf 
Iserjettli the full n^^me of the parameter. Note tliat all tokens \n 
th% ptraiistsrs suppllai to C?KPNOS mast be separated by iltli«r § 
blank or t cosiwa. 



TTP£ = <BEGIMIiND|COiLiCT> 



Oafaylt = EM^ 



'^ ^^IN = stsrt couotsf collection 
FND * stop coynttr col I set I on 

C9113CT « start l$eypolnt collection 
TH i s p^raiister detarmlnss ttie typt of data collection run. 

SAMPLETI^- = <n> Dtfault * 

SHI 

Coynt^r mods — n is In seconds 
Key point mode — n Is In ilHlseconds 
IN is psraiittir gl vas tfit st^^BplIng interytl* Th« set It for 
the intarvai given dspands on Mhether counters or keypolnts 
ire being collected* 

STmiV^'i = <fih.fnm> Pffiylt = DC. 00 

STT 

Tf^ls paraffletar is usad to start collection at a specified 
tliBt of day* If Its valye Is *'00«00*** col I action starts 
imm^^k itely. 

STOPflMi = <fih.inm> Deftylt « m*m 

SPl 

This ptnmttar Is ysed to stop collection «t a sp«clfi«d 

ti?i?a of day* If Its value Is "OO.OO'Vf there Is no stop 

timt process lng« 



HII^SID « <n> 



Oaf ay It 



HID 



This parafflet'Sr Is ystd to spacfly the maclilne model on 
which the collection Is running CS1=1» SE=2* S3=3)» 
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6.^ ^*1F 04T4 COlttCTION CPPKPNOS* C?K^»->4TSI 



H*4»£ K'^'>1IM^ ^^'LlrCTION ?A'5At4=^T'"-^*^ 

Tias? i?ir an>e^«»r s ar^ *jsf^ only ^or t-^ypolnt col I «ctl Ofi • Tii«s* 
tT? lo^ i„Ou?fo_" I aq -^Dd tha K^ y^o Ht^Ca M sot I or^^F lag are set by 



CMS * <YES1nOJ Y|ri> 

Central Htaorf PI1F byffer* 

Keyr»ol^t- Sas^pli Fltg» 

SLF * <rES|Y1H0lM> 

Ktypolnt Selection Fiag» 



Dtf ty 1 t = NO 
Oef-aul t ^ NO 
Def aui t = NO 



SLH « <n> Dsftylt « FFFf 

This paraiietsf specifies tht keypoint selection mask tc be 
yssd in conjunction Mltk tl%B SLF paran^tter* 

SCI « <f»> Otftylt « 

TNIs paraniet^r gi^ss the selection count for class I <wli€fe I 

is In ttia range Cl«*15>« Nott tliat I nyst l3# spacifltd as t 
tMC digit nufibar Ce«g». 00 as In SCOO)« 

rtor© Inforwatlon on tliess paraisisters Is found In the Parameter 
Bl ock sect i on* 
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• PHF DATA CQLlBCTim iPPKPmS, CPKPNCISI 
.4.3 RiSISTiRt2 PARAMfcTSRS 



6,4.3 RESISiet 22 PAR^MITERS 



Tht f sgl sttr E2 parameters allow fyl I €Of»tr<jl of the various 

bytes In the l*HF control rtgisttr. HoritJIy tfi«st do not ii«td to 
be used as appropriate default valyes are ' seleotedl 4170 state 
iata for coynter coMtctlon tnd 180 state dttt for keypoint 
collect I oil. 

ii€li par t?ii«ter Is ustti to set an S-blt oontrol byte In register 
ZZ* A eowpleti description of tiia effect of thn yarloys control 
options Is given In the MIQDS. Hote that tfiere are no parameters 
to ss^t bytis 0^ 6* tnicf .? of rsplstsr is tfits« art always pristt 
ta i^ero. 



n$ StOQ on Hey PQ int diss 
n2 Start keypoint operation 
nl ?HF keypoint request 

SK C = ^1 +n 2 

nl Start keypoint class 
nZ Stop keypolnt class 



ayte 1 control 

Off §y I ts ! 

counter mod 9 - in) 
keypo I nt mode = 10 

Byt*a 2 control 

Oef ay Its s 

ooyntsr nods - Cw 
Keypoirt modm » FF 



sea = n iyte 3 control 

DefayitsJ 

counter aode » FF 
k -typo I nt ^ode * FF 
Each bit set In SCO *«ril cause PNF to terminate processing 
if the corresponding counter overflows. 

Plk « n Sytt 4 control 

Oef au Itst 

counter mode - 02 
keypoint mode « C^4 
This piriiitter gives the Processor Instruction Argument for 
Instruction counting. 

PIH ' n Syte 3 control 

Def iul ts J 

counter mode « FF 
keypoint mode - FF 
This paraf?!eter gives the Processor Instruction fltsk for 
Instruction counting. 
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6*0 ?Hf DATA CniLIJCTItl^ CPPK?NaS» CFKfHOSI 
6,4.3 ^-HGtSTE^- 22 PA8A^£T€PS 



,0 « n Sytf 8 control 

Dtf ly Itst 

coynter wode - 01 

Ttils Ptraflistar fives the sveiit/state seieetlon code for 
coyfitif AO aod tlit ijootrol bit to ANO coyntars AO and 80« 



- ?! 



T^ I s par amat^^r 
counter B0» 



gl ^ js 



Byte 9 control 

Def ay Itsi 

3 y n t *^' r t o .-^ ^ = C C 
k 3 V p a I n ^ <? "i ^ = C ^ 
cv?nt/st^te ^elertlon itn«^£ for 



Ski 



n Byte la cootroi 

Off ay f ts J 

counts r fiO'i'l = Cj 
k ? y 3 n i ■-■^ t ff 1 'a = f ' 
This parameter gives tiie ^v^^i': 's t -^t c? -selection cfi-' for 
Qoynter Al ana the control '>i *: tc ^*iD cojntf-r^ Al ana 31# 

581 == n 8yt« 11 control 

Oef 3.ylts5 

coynter mo^B = OC 
l<ey point isode = OC 

This p-ira»st«f gives ths aytnt/stit® stltctlon coda for 

counter 81» 

SA2 « n 8yte 12 control 

Otfiyltst 

counter iiode = 11 
key point m.o4B - C? 

Tills parameter gives the evant/state selection code for 

coynter A2 tnd tfie control bit to ANO coynters kZ tnd B2. 

582 '^ n Byte 13 control 

OefayltsJ 

counter node = HE 

keypoint mode = 03 
This ptraffleter gives the event/ state selection code for 
coynter B2« 

3A3 * n 8yte 14 control 

Oefaultss 

coynter ipode « 91 
keypoint «!ode = 9C 

This parameter gives the event/state selection code for 
coynter A3 and the control bit to AND counters A3 and B3« 
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6.4' l>^^F DATA CniLBCrim iPPKPHOSf CPK^MOSI 
§.%.3 R5GIST€R 22 ?ARAHET€RS 



S83 - n 



avte 15 oontrol 

counter mole - 1^ 



IN t s 






= n 



Thl^ p»rgffltter InitlaM^ 






it-u«* ^C to tH€ vsjIj?! n« 



Th is 

C81 == n 

This 
CA2 = ?i 

Til Is 

CB2 •= n 

Tills 
CA3 * n 

Th i> 



C :i 3 ■ - n 



This 



! y t i 5 ^' ^ - -? 3 i a 1 1 1 a H ^ • 

partfaattr Inltlsiliiss ^lynt'-T ''^C t-^ t^» y?|y^ n. 

^ y t '' s 1 '•^~ ^ 7 I n I t i .^ i I ? . 
1^-i fault - i'.: 
r--r :>.nft'-.r ltiltl«iiz«s c^jyntar Al to thn value n« 

Bytes 28-31 Inltl al iz« 
Oefaylt « l§u 
ptraiittar Initial lz#s eoynttr Bl to tli® y«|ye n« 

Bytas 32-3S Inl tl ai lir. 
Oefaylt = ICIO 

piftiaettr Initializes coyiitsr A2 to the valya n* 

Sytas 36-39 Initial li. 
Default ^ ICO 
paraiisttr initializes coynter B2 to th# valye n* 

Bftes 4#-%3 Initi al li, 
Defaylt ^ IClO 

pers'?i3tsr l^itl«Hz«»s eoyntsr A3 to the valya n. 

^vtas 44-47 Initially, 
Defaylt = luC 
©.ssramstsif InltiaMzas coontar 33 to ttie v?^ily« n: « 



r 



6.4.^t D^^SC^U^TIriN OF FIllS US-J> 
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^i« >♦%•! I noyt Files 



6, 4. 4.1 lasiJt-^iM^ 



PAiWPL * <fllt nm%> Oafaylt = IHPUT 

TYPS = SiSIN 

SAO « 7 

SCO = c 

This rile contalr^s the data collection paraweters* 



RfcPTFL * <fll« nm€> Oafaylt « OUTPUT 

This oytpyt flit contains tNt oolltctiofi report. 

OEiGFL = <fne fYaiie> D#?tult « FOSG 

This file will contain debugging Inf or usatlon such ss the 

iRag.22 and tha paraisettr block dumps* 

RPTS = <Ki>TS> Oafiult » KPTS 

If keypoint collection Is selected* the keypolnts collected 
Mill be oytpytted on file KPTS Hhlch Is currently a hard 
€0di^6 na»e. 
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•§ PHf HAT A CQlLBCTim iPPKPmSp CPKPMOSI 
♦S OyiPUT REPORTS 



6,5 ayiEiiL«t££fliis 



ftia only output report Issytd by CPKPNOS Is a counter symiisr^ If 

coyrster collection is selected. H^ report Is Issued for ktypoint 
oolltotlon as tliKSt rtports are produced fey tf*e P«F Oata 
Raductlop. software. 



6.5.1 COUNTER SOiHARY 



STSTi« STATISTICS - SE 



i2/il/16. 17.Cl*§fc. 



C'li'^^L "1 in-?/ iTAir^.TTr: 



<-U'" HI f i-'' *,T, C ?''^C "NT 



%^*f , 



1 4 J 8 P 6 



3.811 



i.,i>Tfe'»i:T:^ i rX^MTii^ "^T^Tr^Tic; 



INSTRUCTIONS fcXECOTgD 
I<IIN TIHfc CSECONO$) 
HIPS PiTb 



97096795 



4 J . '■^ 4 9 



SXECUTIV? ^SQGItAH ST&TISTIC? 



TtA^^SFSPS TO EXcCyTIVi! 
aVG. time in tXiCilTIWS 

TI'IF IN £K£C*JTI¥E 

psrcentase in executi^h 



35516130 



1.988626 



4 3.449472 

4.577 
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6.6 0££iiIlfli4i.£ifl£iByifS 

6.6.1 m$jkLikiim 

To install thest proirtws ttir«s fil«s ire fia«dtdi PliFPl# XULI 
arid 'PHFPIIS. To coapile ai^d sysaclit the PP felnary typet 

SSS.PHFIHST PPKI^NOS 

SrSiOIT, 8*GR0UP. 

To coispila tnil save tlia data colltctiof^ proifa:W typss 

SSS.PMFI^ST CPKPMOS 



6.6.2 tUHNINS THE 0AT4 COiliCTIOH 



To 
Hi tN 

22* 

ttst 

•data 



itgifi the oon«etlon of stttistlos* a jo-b iiyst fee sybiltted 
tNs data card TYP£ = BiGIM. This ^111 ir^ltiailze rtgister 
and start the evant counters If^ the PliF hardware. Hher the 

period Is so?!ipltts# rtsubiilt tht jofe with tht TYPE * ENO 
ctrd. The event coynters Mill be read from PHF and the 



progrtffl CPKPNOS Mill output a Mstiog containing t^e statistics. 



The prograii CPKPMOS 
kaypolnts from the I8§ 
runn ing. 



fliiy also I 
side of the 



used for the collection of 
lachine when Dual State is 



Mhlle oollectini kiypolntsf tht job will normally r^m%'in it i 
control point until PHF hardware detects a stop condition 
(counter overflow* stop keypoint). The Job can be terminated 
prior to this by the operator comniand *»n*CPQ.STOP'v. Nor Pa I end 
processing is begun by this entry and the keypoint file will be 
correctly produced. If the job Is dropped* the keypoint file may 
not contain all the desired keypoints and will not be terminated 
by the record which contains register 22. 

If keypoints are Issued too rapidly* the buffer in CPKPNOS itsay 
b%Qom® full. If this happens* keypoints way be lost. Mhlle this 

problesi Is unl iktly when the file KPTS Is assigned to disk* It is 
a sosslbjlity If the keypoints are being written to a tape. Mc 

arror mBss^gt is currently Issusd if keypoints sre lost. 



The Ksyoolnt file profluctd by CPKPNOS cm be 
the keypoint pr ^-processor program CKPPRE). 



i npy t d i r ac 1 1 y to 
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&«6.3 CPKPHOS RtJH PROCgOURES 

*4ri ? - "^ Dfooeciura «P*4f» Is syppllecl. It Is raco??"i?erd2d that this 
9r ■'ic b^ If^st«n2»d on ystr nyi«l>«r STSTr^K or LI3»iev |rj or?1tr to 
al lOH the operator to inltiste a ^ata collection bf typlrsgi 

M.PHFIpartinetsfsl 

i«hers ttia pari««tiir descriptions if« is follOMSJ 



HSIMQES a£iCEi£IIOi 



TY 
HI 
IF 
OF 



LIB 
LIBIIN 



type of CO II set Ion 

machine type 

Input Ptfiiatttr file 



COLLECT UBQIH I EUB 

SllS2rS3 

file nnme 



statistics oytpyt filt file n^m\ 

tapt nyrobtr tip« vsn 

Clf CO 1 1 act ion on tape* 

ottier**ls«! th% disk 
file KPTS Is assymed? 



tap« density 

i I bftry containing 

XCfKPNS In UilB format 

user nufliber wliere 
I I fertry I s located 



PSf 5E,f etc. 
life name 

user Id 



END 

$Z 

none 

none 



P£ 

xuiia 

KEYPiRF 



Soma txtflfiples of how to use PPif foMons 



SES.PHF 



This call Initiates PHF counter 
col I ect i on* 

This Oil I terminitts PHF coynter 
CO Meet I on* Tl^a oytpyt Mill tee 
found on file OCPKPMS. 
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fe«0 PHF 0AT4 CQll£CTIy!^ iPP^PHQSp CPKPHQS) 
■6.6.3 CPKPNOS ^UN PmCtMRES 



$BS*Pm TY^SiSIi IF«IMriLI 



This cill nHi lnitltt« « P«F 
coufiter collection ysl«g the 
irtpyt filt IMFILE to ctiifigt soffl« 
or all of the ief-.22 ssttlng. 



SgS.PMF Tr«€Oll£CT 



This call Irsltlatss PHF ke^point 
coll^ctloo* Tlia collfcttd 

Iteypoif^ts will be found on file 
KPTS. 



SES.Pf^F TY = COliiCT TPF'ABCOOl 



This call initiates PHF key point 
coMftction* Tiis coH€cte<l 

keypolfits mIII b% foyrsd on tape 
ASCOOl. 
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?.<# KEYPOIMT OfcSCHIPTION PARSSi CK?^A«) 



' . ti£X£aiiI-i£a£Sl£2IQi-£4EMS«i^E£4ii 



Tnis Droorsfr was originally Hbedded Into the ore-proc? ssor 
pfocir^'Ti* ^or Obvious ^tBSons of r^dyndincy n stufKl ,4lon« pro^riin 
*^as b^en huilt* This approach h^s choosen because the reed o^ 

par^lnq t*^e co^P^non decks is only nh^.n changes to the cofit^on decKs 
are 'io?^«« Thus? every t\m% th3 pr »-3roc-assor Is us«i» thsre Is 
no r^«e?l to re-pars« all the comnon dacks* 

Tills progrBM ptrst thtkfty point Qomman decks and gsfirates a siore 
concise hlnary file Mhich tha prt-prootssor will ys€ ovir sod 
ov er • 
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?.§ KEVPOIHT OiS€RII>TION PmSER CKPPARI 
7a KPPAt GgNStAt OiSCtll^TIOl^ 





7»X il££iE.Mi£Eii»MI£IIfIiOi 



file summer itkng tt^« kaypoif^t dtscr I pt Ions* for yse by the 

prfprootssor* It 4q^s also clieck tfi« syntB% of every 

description according to the langyafe specification. Error 
pessti«s i^ 1 1 I t>a printed tccordi nily« 
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7.0 KEf'POIMT OESCilPTION PARSER CKPPAR) 
7*2 DESCRIPTION OF FligS USED 



7*2 a£icai.£imi«a£-.£ii£miii 

7.2.1 IHtUT FILiS 



WtHFli This fH« 0©otilns tlit Input ptriffltttrs for ttit control 
of the prQ§rBm» 

KEYDSSCj Tills filt coottlns tlit keypolf^t copsion dect? descriptions 
neaclsd for tht processing of th# k«ypoints« 



7.2.2 ayT?>CIT FILiS 



PAHSFl? This fila eonttlns the parsed descriptions of the 

ksi^polnts* Th« ptrslni products a filt of descriptions of the 
following format* 



5 5 4 3 £ 1 C 

9876543 210987654321098765432109876543210987654321098 76543210 



.-f.^. 



4— ■ 



keypoint description "- ^ord 1 
ktypolnt description - Mord 2 



ktypoint description - word 3 



+-. 



ktypoint description - word 4 
ktypoint dtscription - Mord 5 



+-» 



^.-. 



keypoint description - word 6 
k«ypolnt description - *iord 7 
keypoint description - ^ord 8 



4— ■■ 



datt I denti f IcitI on - part 1 

,-«— «-.— — -«.™ ^ «-+- — -«.—.— — «-- . — «-., — «- 

data Id - part Z I/////////////////////// 



4.-, 



.+«+. 



'+ + 



b 



}cS d I t S f I 



h 



count (Integer) 
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WNSf If 5 
i 

c 



h - 



kBf point number 9 
sub^\4 isatch ¥@lu«# 
data fomattlni^ 
syfe^ld uttcfi tBngtit 
data length* 
ktypoiot Glass* 
special case flag* 
dsserlptiofi lf>«JtM* 



OcSGFlt This filt contains somt psruiantnt 4^bu§g\n§ information* 

Also* lists Input lines which do not conform to the langyage 

sptcif icit I on* toitthsr ^1 tti tn axpltnatory error or wtrnlng 
ness ages* 
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1»Q KE'fPnmi 05SCRIPTI0H PARSED (KPPARI 
7,3 OPS^ATIOMAL ^ROCiDURSS 



?.3 afEiiiioiiUEaacLiayEii 

7.3.1 INSTALlATIOil 



To If^sttil tills prograa thret files are neede^t f>MF?l^ XULI8 and 
PHfPllB* To coiRpI Is aoci s«¥s tht blniry of tt?« parser proifaii 

SSS.PilFIf^ST KPPAR 



7.3.2 K^PAft mu PROCEDOteS 



An SES proc file Is supplied in order ta run tlis parser PfOiran. 
Tills proctdurs wIM «nal>le the yser to tscecyte the prosrai 
locally or sul>filt a fcttch jolb. Tht folloitlr^g piriPtttrs «f« ys«<l 
Ml th In the procf i I e. 

Any of the parai^etars deflr^ed In the SES modyle J08PARH siay be 
used. Thtst Include 4QB11, J08FI, 40BCH* J08Pt# JOBUN, JC8PII* 
JOBF^IY* J08CN# JOSPH* LQCAlf SATCHM.* SATCHf DEFSR^ NOOAYF, 
04yFIli» ANC OF. ISet SiS Proctdyre Writer's SyldSf Appencix A3. 



PRP- 



.;:'* ■;*% It"* 



II B 



f*ifstd ktypolnts eowion 
oytpyt file frofli KPPAR. 



decks flit. This f I I a Is tl^f 



Default pmSfL* 



This sp«olfi€s the nnmB of th« file containing tht 
cowiBOn decks. If no file is assigned* KPPAR «i I I 
atte^spt to get th« co8?mon decks using file K£YO£SC in 
user number OEVl. 

gxtiBPIt COF'KSYO Default KEYDESC. 

If the the preprocesse*^ ksypolnt datt file is in another 

user's area this parsfflster liust be specified* 

EKtiRpla ID^miZ Default KEYPERF. 

Haiie of file where the object code for XKPPAR Is found. 
Ordinarily this parameter Is obtained froni the 'toolilb' 
parameter In the user's PROFILE. This paruneter *foyld 
ordinarily be used for testing a nen version of the 
pr eprocessorf or for use of a specially ?^odifled version 
of the preprocessor. 
EMampla LI8«HYLIS Default XUIIB. 
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7.Ci K^y^niil DESCRIPTION ?AR%m- IKPPm} 
1*3*1 K9PA^ Um PPOCcOUPHS 



JBUH User number M^iier-t file specif. ltd by LIB C above) r«sld-@s« 

Ordlf^arlly this ptrapeter Is ©btalned frop the •tcolact» 
Ptrtaetar in tha ustr's PtOFILE* 



So??ie eiawples of hOM to Irivoke the KPPkk prootdyrt follow? 

SgS.KPPAR Tliis call will parse file 

KSYOgSC and ths pmrsmd^ oytpyt 
silll be foynd Into file PARSFL. 



SES.KPPAR LOCAL 



This call nl M ryn Interoat I ve I y 

til© job mlth tha sant defa-ylt as 
In the prevloys ax apple. 
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-.1 KPPI^£ GcNcRAL OESCRIPTIOM 



8.1 flE£a£«£IliEEAi.O£S£il£IIOM 



Tha KPPRfc proiriii wl H tcctpt slmylator^ softmrt* or ii«rdM«r« 
cQllectad key points ar?d the NOS/VE keypolnt coifflCfi dtcks flla as 
Inpyt andf dspan^lng ypoo the input partaetarsf i-il M generate any 
oQiblnitlor? of J 

ksypoint trace report 

ktypolDt description file 

pr «-pr oc«ss«d ktypoint data filt 

It has tfi« capability of oytpytting trace reports ^ne 
pr 8-proc esse d outpyt files for all Naypoints encoyntered In the 
dtti or only for thost fctlonglnf to t spuciflid, task» Processing 
may also be turned on and off on given keypolnts* 

KPI>R£ Mas created by siodlfying and amal ga^atlng three existing 
ktypoint proctssini proirtffts. In the proctss.* a nypfoer of 
existing Ijygs were corrected and tha yss r Interface Improved and 
made SCI like. Tills prograip «as ^ritttn in CY8IL-CC In order to 
simplify Its eventual :ail§ratlon to CYill-II under NOS/V-E* It 
cyrrtntly ryns under ITO state NOS versions 1 and Zm 
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8*0 KErfoiNT ?m?mtE$$m iKppm) 
8.2 CONTROL pmmmBm 



i,2 naiiaaL^Eiiiiiius 



AM control Ptrimeters may l>e sps€lflad fey tItNtr tiialr fyll rjane 
or fey 1 or^e to ttires charactar afefersv I attorn* lii tlie follCMlng 
cits§r Iptlons* tfit ifefcr tvi ititjn is stionn dirtctly ynd^rntath thB 
fyll piraiieter nane. 

flLiffPz ^ <SIH1SOFTSHAR0> Osfaylt « HARD 

FT 

This parafiattr specifies Mliether tfie li^pyt keypoint file Is 
froi tli« C18§ slmylator or from softMtrs or PHF lisrdMtri 
coilactlofi un<l6r IIQS/VE» 



OlrSC = <Y£SIMaiYJH> Default « NO 



This partiittar specifies that a keypolnt descrlptlof^ file 
Is to fo« outpyt* This fll» Mill b% ys«d as Inpyt to 
fyfthsr data reduction progra?ns. 

mmm%t = <YfSlflOJYIN> Defaylt ^ NO 

COS 

This paraiaetar specifies t^at a l<eypolnt description file* 
containing only the dtscriptlons of tt^e keypolnts 
encoyntsred In the Input filaf Is to foe generated* It is 
put 4Qmf\ as th« first ra-eorcJ of the ktypolnt oytput flit. 
Note that this toggle Is forced on If pr e~process I r§ Is 
rt^yested since the data redyction mHI not motk without 
the compressed description* 



TRACE « <YESfHOIYJH> 
T 

Th I s pa r aie ts r spec If I es If a 

q%n%r «ted* 



Default « HO 
trace report Is to be 

Default * Y£S 



m&n ^ <YESINO|YIN> 

P 

This parameter specifies that t pr e-pr octssad keypoint file 
Is to Ise generated* This file nil I be used as Irput to 
further data reduction programs* The compressed 

description toggle Is forced <in» The compressed 

description Is the first record on the oytput file i^hile 
the processed keypolnts are the second* 
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T4SKI0 » <n> mh%f% n Is i ny««f le task If) D«faylt « -1 

TK 

This paraatt«f Is ijstd to oytpyt tli keypolnts btlonglng to 
t^e specified task onto a file, for fyrtl^er processlfig* Its 
bist way ,b« sptolflsd In Ptrtntli#sis ifttr tht nymber* 
exaiplfiJ 18C16I « 24<10> » This flla «a,y thari be ysed as 
Inpyt to tilt data radyctiofi programs* 



SKIPKPT « <n> Mhert n Is « ouiitrls vtlys 
$K <*99999999 



Otftult « 



TNIs paraniettr is ysad to skip n keypolots at the beginning 
of the Inpyt f1 l€# (Hote thit this coynt Is not tMict is 
tfi« nyiibar of keypoints skipped wl H be the next, larger 

«yltipls of the nymbsr of k#y points per buff«r«) 



MAXKPT - <n> Mhere n Is a nyper Ic vtly^ 
m <«99999999 



Difault « 99999999 



This ptrapater Is ystd to specify the actyal ny^btr of 
keypoints to be pre-processed CexclydIng any skipped fey thi 
SKtPKPl p«rapettr). 

$TA?T = <ic> <y> ¥iti^.re n Is a class no« and Oafauit = -1 -1 
STR y a keypoint no» 

This parameter specifies the keypoint to turn cyclically 

the pra-procassor on* This parafneter oyerride the task 
selection* 



STOP « <n> <y> ^htr® x Is a class no* and 

$1? y t keypoint no* 



Oeftylt « -I -1 



This PtrtPeter specifies the keypoint to tyrn cycllcell^ 

the pr e-procissof off* This parameter o^err\6e the task 
select Ion* 

MoteJ It Is not advised to yse start/stop toggllni at tht swm% 
tiffla as tisk selection becayse the task entry keypoints mIII only 

be recognized if they fall within the Internals defined by the 
start and stop parameters* 
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i*3 £ILi.iiif.£M4iiIi&S 



This psraiseter sp«clfl«.s tli# Input fllfs lii wtiicN the 
coll@€t8<l keypolrits reside* 

PARSFIIS * <file niii€> Osfaylt * PARSFL 

This ptrtitt-sr specifies tlie inpyt file where the blftar.f 
parssi dtscr ip tl oris rtsl^a. For mora datalls .ste KPPi^R 
sect t tin* 

RPTFIIE « <fila ni«t> Default « KPTDFl 

KF 

THIS paraiister specifies the prs-pr ooessed Nsypoliit oytput 
flit for fyrthar proctssing by th^ data reduction proirs?ws. 

TRACFIIE « <fils fsaiie> Otfaylt « TRACFL 

IF 

This p«.rt«0tar specifies tht oytpyt fil« for the trace 

report » 

TASKrILi = <fnt rjajne> Default = TASKFl 

TKF 

This parameter specifies the name of the output file to 

^^hlcfi pre-pr ocesst<l kaypolnts for the task sptclfled by t-Ne 

TASKID parafiieter are to foe written. 



Default 



KlUGFl 



KIUSFIIS = <fi le naisa> 
KLF 

This parameter specifies the nnme of the input file which 
the pra-proctssor checks to altar the keypoints It r-^§.4s in 
to make them fit the descriptions the pr e-pr ocessor has* 

It , Is a aieasurt to proylde a temporary fix for 
discrepancies toetween the keypoint coiimon deck descriptions 

nndt the actual i:sipl«iiientatl on* 



Note that t^o file naiiias are currently hard-coded* Tt^e Input 
paraiieters ^tb found on file "Pl^^HFL*' and debug output Is written 
to file «D£8GFL«. 
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8. % SiiaiISIlQi>Q£-£lLEI«IIIf 2 
«•%•! INPUT FILES 



PARrtFLi Tills filt contains the Inpyt pameters for the control 
of the txteutlon of ttit progrti. 



>AT4riJ Tills file Is a biliary file coiaposed of elglit IZ^blt 
•arcals par ke^polnt Csee Data CoHtctlon for ^ore Inf orpat Icn) • 



PARSFLi This flis contains the p^rs^fi keypoint <l-8scr IptI ons* See 

KPP4R saotion for laort details. 



KLIISFIJ Tills flit Is ys#d to redtflnt k«ypolnt descriptions «nd 
Incompatible keypoint entries bat*iaen tfie co»i8on dtcks Bn4 tlis 
actual cods* 

Itngusis sp«cl f i ctti on for tht k{u4§m flMs 



k I y d 
ki yd 

old. 

ol as 
old^ 

kpn_ 
kind 



Hit to 
keyp 



ia_f 11 e X 2 = £ <kl ud gt> * » . 1 

ga *s= <old.class> <spc> <old,.kpn> <spc> 

<k lydie.ictl on> 
class 15* <c I ass. range > 

s.rtnge 3 J* 0»»0f(16) 

kpn II- <kpn..range> 

ranit is* 0« «Off f C16) 

ge.actlon ii« D <€ol> I 

C <spc> <naM.class> <spc> <new.kpn> <eol> 

CD i <spc> <mitch_yal yt>1 <eol> 

<keypoi nt.descr lptor> 

<clsss.rania> 

<kpn.ranga> 

O..Offf (16) 



CI as s 
kpn 

h^.yt I y«5 

ol nt.descr i ptor *i» ^s described In IPNOQC appendix D.l«5 



1 :« 

J 5 s 



Sxantple of a klydge fllei 
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8,4.1 Xl^pyT =ILES 



2 4^01 C 3 40^^1 

3 ^001 C I 4001 

8 ?61 d 

9 73l d 

2 1654 C 4 1654 
£ 250 CO 

Cc *cJp$oicl ditt Itr^it^ wts %8» •cosii?iiaiidl» kZ§ > 

4 297 

3 1106 Cd 9 

CX 4.9 »chg dtsc mi/ iitcti.valf add data fi«M' «saifii®nt* H16> 
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8.0 K?YPOIMT PRSPftOCfSSOR CKPPRE) 
8. 4.2 3UTP:IT -UrS 



8.4.2 OUTPUT FILES 



KPTDFl? This Is %n oytpyt fllii eontmlning thB leslblf 
coiiprassed descriptions In the first record tncf tlie 
pr«-proe«ss«d kaypolnts In tlit second in tf%% form of pairs of 
■Hords. 

Tilt dis<5r ipti on.s art p&rsB6 from the common decks into the 
folloviini fomit* Indtx^ Station Id* Cliss- No«* Kpn> Match 
¥alye# Hatch Ltngt^ti.* Flagt Data Langthf Data Foriat.* Oata Id* 
Indsntatlon* Htsstgt* 

The second record consists of t>lnary pilrs cf words Cfor tf^t 
hard kaypolnts) containing I nf or aiat Ion as shown In the 
dl M§rMm baloii. 



S S 4 3 2 1 C 

987654 32109876543E1C98T65432 1098 765 4321098765432109 876543210 

lOS timer Jcl.l desc indtx If lags I //.//// 5 

^.«— .«, — , — «-«»—«•«— .4-. «-™«.-™«-.^-.«™.«-.«.-™™«-«-.«™ ^— # 

? data valys Jkeypoint noj /////////////////////////// 1 

- buffer overflow flag* 

S - software lost dttt flag* 

flags? HDCTjTii 

H ■- 180 f?onltor mode (1 bit) 9 
- split data flag <1 bit)* 
C - 170 state (1 bit)* 
Tj - joi3 trap handler iZ bits)* 
Im - monitor trap handier t2 bits). 



TtACFLi This file lists all kaypolnts encoyntered and nil the 
data which they were carrying. This Includes times* delta 
tln?es* kpt numbers* classes* task nymbers* modes* data* data 
foriiiat* section and message. So^e of the Informstlon Is 
drs^n from the corresponding descriptor entry. 

If a specific task has b^^n requested then only the task with 
the requested task number v^ 1 1 I isippe^r In the trace file. 

The trace file also contains summaries of the key point 
descriptions* the undefined keypoints encountered* the nua?ber 

of kaypolnts encountered* the hardware and software overflows 
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8»4,E OUT^^MT FUSS 



and horn iiany ^^er« delst#cl froa tlia outpyt file* 



TASKFL5 This file Is In 8Kt€tiy the sa^e foriiat as }<|5TDFi 
txcapt tl^tt only tlicsa keypoints found for the specified task 
are written onto the second regard. It Is Intsncled to ti« 
ys«d as I npyt Into fyrttier data reduction pJiases wiien only a 
singia task is of Interest. 



DESCFli This fl!a oontilns th« compr tsstd ktypolnt 

descrlctlons for all tfie kaypolnts In ths systeiB or only th€ 

keypolnts wt^lch art In the oolltotlon flit tsas partipet€rs 
DSC or COS). 



OE'BGFls This file contains a listing of the psrsiiettrs* and 
oth^r debugging Inf orinat lon» If the trace toggle Is set 
there ii«y be diagnostics for iionltor and- trap antry/^Mlt out 
of sequence* 
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i*5 QyiEyi.iiEoais 

8«i,l KSYPOINT TRACE 
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3 


^iii,l 


J 


17 


m 


K 


EXIT 18'3 ^0^1*^0^ ^1^^ 


5606 


23 


C 


H 


f IcJ.ord 


Z 


171 


J 


17 


8A 


£ 


baplpet.nsxt 


563^ 


3 


f¥ff 


H 




CI 


4CI95 


J 


17 






tt* f«HPXOf(;TFl r*4T|i i<OT 


5819 


210 


30 


H ♦ 


fbi 


2 


1$Z 


a 


17 


SA 


£ 


fc a pSb 1 oek_'«i <*r^ 3iq a r 


3^^? 


1E3 


3 


H 




4 


152 


J 


17 







4;4:s^^)^4ci!:# yMf)«rf:T»^cri i<^^o 


3931 


10 





H 




3 


152 


J 


17 


Bk 


X 


biPSblock^iitan^oer 


6062 


110 


ID 


H 




4 


171 


J 


17 




e 


#«#^4ti|c«t }jiMf5PS|s|rn i<cf3 


614 8 


86 





I 


statys 


3 


171 


J 


17 


8A 


.X 


baplget.next 


615^ 


10 


656F72 


H 







3954 


J 


17 






#** yt^^XP -C^^O nAT4 <?»T 


6161 


3 


10 


H 







16 


J 


17 
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8419 


118 





I 


status 


3 


182 


J 


17 


8A 


X 


bapSput^next « ba 


8423 


4 


1CI86 


H 







182 


J 


17 






*** UNSXPSCTfO OATIl K^f 
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8.0 Kt:V?OIHT PRcPROCcSSOt 



CKPI>til 



8#5«2 KiTI»OINT Sy«F!ART 



KEYP 


OINT 


sunnAm 






Count 


Sect 


CI 


Ty 


Kpn 


MtSSifS 




4 


AH 


£ 


E 


101 


ai^P Sac cess, fflstliod 




4 


kn 


s 


X 


lil 


Qmp% BCGBSS^mBthOd 




4 


m 


2 


E 


105 


a?ip$el<jsa 




4 


An 


3 


K 


lis 


ipp$clss« 




1 


kn 


, z 


£ 


1C8 


««p$oopy_f i l€ 




1 


An 


s 


X 


l©8 


a«p$copy_f 1 1 a 




1 


An 


2 


£ 


111 


aaip$f atcti' 




1 


kn 


3 


X 


111 


a«p$f etcN 




28 


m 


2 


£ 


112 


ifflP $ f a tcli^icc ass_ 1 n f o r p at i on 




E8 


m 


a 


X 


112 


asipS fetch.access.lnfoffiation 




26 


AH 


2 


E 


113 


afupSf a tch.f ap^poi ntsr 




26 


kn 


3 


X 


113 


aiiapS f et c h„f a p_ pointer 




5 


AH 


Z 


E 


117 


asipSget^f 1 1 e.tttrl tjytes 




5 


kn 


3 


X 


117 


afl3p$get,«fM e..attr 1 bytas 




28 


An 


z 


£ 


119 


ipp$ ge t. na x t.. May 




28 


k^. 


3 


X 


119 


a?jiP$iat_nf xt.key 




4 


AH 


2 


£ 


121 


anpSf et^ptrtl il 




4 


AH 


3 


X 


121 


afflp$gat^paf tl al 




4 


AH 


2 


s 


125 


a:fpp$open 




4 


AH' 


3 


X 


IZ5 


■Bmp%QP^,n 




2 


An 


2 


E 


127 


%mp%put,^4\ ract 




Z 


AH 


3 


X 


127 


aflipSpy t^dlrect 




73 


AH 


2 


£ 


129 


a.8ip$put.n«jct 




73 


An 


3 


X 


129 


awpSput.next 




6 


AH 


2 


E 


130 


i?ipSpyt.P«rti il 




6 


An 


3 


X 


im 


anpSput^^partl al 




6 


AH 


2 


£ 


133 


nmp$return 




6 


An 


3 


X 


133 


aippSretyrn Status - => normal 




1 


An 


9 


s 


146 


tfflp$stor:a_ftp_pointtr 




1 


An 


3 


x 


146 


asipSstor e«f ap.pol ntar 




29 


AH 


2 


E 


148 


val i date^cal 1 er^pr i yl ! age 




29 


AH 


3 


X 


148 


vail date.cal 1 er_Pf i v 1 legs 




21 


OS 


2 


£ 


1403 


osp$sat„stttus.abnor?»al 




21 


OS 


3 


X 


14li3 


ospSset.status.abnofffial 




1? 


OS 


2 


£ 


1404 


ospSapptnd^status.paraiustef 




17 


OS 


3 


X 


14«I4 


ospSappsnd.status^paraiueter 




1 


OS 


2 


E 


1405 


osp$tppand^stttus_ Integer 




1 


OS 


3 


X 


1405 


sp%% p ps nd«s t a tus. Integer 




121 


OS 


4 





1447 


al locate 




106 


OS 


4 


D 


1448 


free 




61 


BA 


2 




152 


bapSbl ock^iwantger 




61 


8A 


3 


X 


152 


bapSbl ock^manager 




3 


8A 


2 


E 


155 


bap$cl ose 
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*5»3 rnKmyin Kmpoinr smn^m 



8,5.3 UnmB^U KEYfaiMT SUHHAty 



FiNiD KmpQmj smnmy 

Cl«ss Ktypolfit Coynt 



15 





I 


i 


1654 


I 


z 


1132 


3271 


3 


1132 


32T1 


2 


1133 


Mil 


3 


1133 


3271 



TWAl KPT PmCBSSEB 
DELATED KPT « 

TQTAl Kf>T ON PROCtSSfcCI FILE = 
TOTAL UND€FINiO KfYPOIMTS 



219118 



E19118 

13007 
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3«6 a?»£^4TI0N4l P^OCeoUHES 



8, 6 oiEiiiiiMiL^EaQaf ayiis 

8..:6.1 INSTAiL4TI0^ 



To Install tills prQ§rnm ttife# files tre nsai^ii PMFPLf XUIIB and 
PHFPLI8.. To coppile afid save the bif^ary of the pre-pr ccessor 

SES«PHFIHST KPPRt 



8.6.2 KPPUB mn PRQCEOURIS 



An T^S Pfoo fll® Is supplltd If^ ordar to run t-he pre-pr ocassor 
program. The following partfB«ttrs art us%-^ i«ilthin ths procfll«. 

Any of the parameters defined in the SE3 modyle JOBPARM nav l3e 
ysed. Tlies€ include JOBTl* JOBFL, JOSCNf JOBPR, J08UN* JOBpy^ 
mBfnUf' 408CN, JOSPH* LOCAL* 8ATCHH* BklCH, DBfeUs HOCIYF* 
OAYFILEf AMO DF. ISea S£3 Procedure Writer's Gulden Appendix A) 



TPF 



OTF 



OSF 



FRF 



If the ray input data Is on tape* TPF Is used to specif]^ 

the VSHCs) of the tiptts) on which tti« data Is foynd* 
If the VSHIsl have leading §s the VSN «yst be enclosed 
In single quote marks. If the data is spreM4 across 
?iiore than one reel* the list of VSNs luyst he enclosed In 
par entties Is • Dp to IS rttis of tape may foe specified. 
Tapes must fee labeled. 
€x3?^pla TPF^C •00§i23»*l234S6) Default none. 

If the raw keyooint data Is on mass storage* OTF 

specifies the flit nama In i«hl oh the data is stored. 

The file iray be local* direct access* or even Indirect 

iocess although the last ilternatlve Is usually 

Impractical. 

En-ampiB OTF-DATAFL Default D.ATAFL. 

This partpsttr specifics ths file nhsre the keypolnt 
descriptors will be stored. 

£xa?iple DSF*DiSCFL Default none* 

required parameter. 

Parsed keypolnts coufnon decks file. This file Is the 
output file from KPPAR. If the PRF file is not found* 
KPPRS runs KPPAR to create one. 
E)<awp|e PRF«:PARSFL Default PARSFL. 
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8.6*2 K^P^r '^UM ^ROCcDUftES 



KLF 



Kl^f 



S?F 



TRF 



TKF 



;kp 



HKP 



STR 



STP 



TSK 



T^Nis p«rt««ttf alloi^s spaelflsttlon of t flls contilfilng 

iofoniatiori about kefpoints i*lilch stiouid l)e ignored or 

srroneoys <ysyaliy bectysa ttity 

Ifistilledl.* 

SxiJiP 1 1 Kll=«KLU9FL 



Tills partn^ttr sptclfies th© fHt 
pffprocessed keypolnts mIII Ijs stored* 
gMiipla KFF«KPI^1 



art I Improperly 
Otfaylt KlUSFL. 

Otfiiiit KPTDfL. 



This paranttar «Ho^s ttia VSH(s) of m output tape on 
Mhlch the preprocessed keypolrsts will h% storei* Note 
tfiit SVF spaoifles only tlia VSHCsJf KPF Is stlM 
rs«iyir«ci# although KPf Is no« the IFH of the tape. Up 

to 10 ¥SNts) mty !)« sptclfled. 

ExtiiPit SVF*l*O0Oi23»>«0§O%55«l Otfiylt nont. 

This parameter specif las th^ file name for tht trace 

fiia niiloh stores diagnostics and d«ta about th€ 
k 0ypo I nts ♦ 
gxaiisple TRF«TRA€Fl Oefaylt TRACFl, 

Tliis parameter specifies a preprocsssed keyoolnt file 

for i sti ectei task* 

gxassple TKF*TASK1 Oefaylt TASKfl. 

Number of keypolnts to skip at the beginning of the rau 

ktypo Int f I It* 

^xBmpie SUP^imO Default 0* 

NaKinjyi nyifsfesr of keypolnts to process from the rsM 

keypoint til«t« flit. 

Sxapplt nKP^ZmO Default 99999999 

Start class and key point. This parameter allo**s 
sitrching the r^M keypoint dtta flit to the point where 
a kaypoint of a given class is found. The foriat Is 
'CLASS K£YPOIHT». Space batneen class and keypoint Is 
required. See note on cycling In STP description. 
SKmp\% STR«H 4000' Oefauit •-! -1 » . 

Stop class and keypoint* This parameter alloMS stopping 
the preprocessor after a given keypoint has been found. 
Note* hoMiever> that collection i^l 1 1 resume If another 
keypoint of STR class %n4 keypoint Is found* so that 
this start stop process Is cycilcal* 
Exajrple STP«'4 4001» Default »-l -1 « . 

This paranseter allows selection of only those keypclnts 
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9.0 Ks^»QI'1T PRfP5?0CgSS0R IKPPRS) 
8.6.E <«>*i?^ tJJN PROCEDURES 



PRE 



FIT 
TRC 
DSC 
ID 



LIB 



1 1 SUN 



0orr«spofi<ll ng to m §iy%n tasN t^o tea firtprocessed.* 
£?caiiple TSK«5 Default -!» 

(all tasl<s)« 



Tills is m tcfil 
f I fe. 



to prodyss i prtprocessed keypolrst 

Default Y* 



TNIs is a togglt to pr oduot i coi?presst<l ktypoiot 
d-escr iptor file. 



fxiropls CDS=N 



Oeftult ¥• 



This Is i togglt to ftp face tht itscrlptlon Into tl^t Pl» 
Bxmmpie RDS«Y Oefaylt ^i. 

T%is parasnattr specifies the type of Input data on the 
keypolnts flit* Allow«ljlt typts ir« HAI^O# SOFT* SIH» 
gxafiipla FIT=SQFT Default H4tO. 

Tills pafiffleter specifies Mtiather trace outpyt Is tc be 

itn«ritecl« 

Exaiiple TRC«Y Default H* 

This pararoeter specifies nhether a full keypcint 

*ltscriptor flit Is to be generitacf. 

Example 0$C«Y Default M. 

This parisieter allocs specif I cat Ion of the UN of the 
^o:rkspio« contilning certain files* This allows t 
single copy of these files to exist* simplifying 
procedures when they are updated* The files accessed 
using the ID parameter are KtF# PiF and DTF« 
Sxtmplt ID*KiYPERF Default user's 

own UN. 



Hame of file nhere the object co^de for XKPPR:E Is found. 

Ordinarily this parameter is otstilned from the 'tooHib* 
parameter in the user's PROFILE* This parameter *<cyld 
ordinarily he used for testing a new version of the 
pr tprocessor* or for use of a specially modified version 
of the preprocessor. 
Sxaf?ipie LIB»HYII8 Default XULIS. 

User number where file specified by LIB (above) resides. 
Ordinarily this parameter Is obtained from the 'tool act* 
parameter In the user's P?^OFILE. 

Sxample LXSyH*UH12 Default KEYPERF. 
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Somt ti tup Its of lio*^ to Invokt tilt KPPiE pr?>€eclyf« foHoi^J 



SiS.KPPRE OSP'DESCF 



SiS*KPPRI OSF^Di TI?C«T OSC = T 



This call Hi 11 pr f-p roc «ss file 

OATAFL and oytpyt the 

prt-procsss#i ktypolnts into 
dafault f J le KPTDFL. 

This call will do the afeove and 
Mill also i«r^«ritt th« tr«ce 
oytpyt and print the full 

ktypojnt descriptor flia» 



ESS.KPPte TPF=^8C002 PSF*DSF1 



This call will process the 

keypoints collected on tspe 
A8C002. It Hill not generate a 

fyll pr«-proc«ssed ktypolnt f i I i 

Ijyt ^^111 output a salective one 

for kaypoints beionilng to task 
nywber 4 CTASKFLI • 

SES.KPPRS DTF«KPTS DSf=Dl TRC«Y This call i«lll pre-process the 

k«ypolnts on disk file KPTS* 
ganerating a full trace report 

«nd outputtini tha pre-processed 
kaypoints on file KPTOFl. 



SsS.KPPRg DSF^Dl TRC^Y fiKP ^imO 



SS^S. iKPPRS OTF^OIOPAR DSF*Dl 



This will produce a processed 
ktypolnt file called KPTOFl froii 
the first 1000 keypolnts of the 
input file DATAFl. It will also 
produce and print the trace file 
TRACFl containing the first 1000 
keypoin ts« 

This will produce B.n<i print the 
fila KPTDFi con t fining the list 
of the descriptions contained on 

the binary parsed file OL0P4P. 
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8«6.2 KPPt? f?.llN PPOC£DUR£S 






'1 nKp^mm ski>=ioooo •* 

This will create and ryn a bstcli 
job to prB-proceMS the i4,CC€ to 
llOOith kaypolnts Capproic.l* and 
Pflf^t their descriptions* ITIie 
COS Is forstfl on tnywtyl* Th« 
job win also creata TASKFl 
which contains tha prt-pr ocsssed 
key points of tasl< nyiiber £4 
dad iial « 
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2% Felj 04 



9. EiiaMX-.MI4«EiSyOIIli«llS£i£ai 



TNa PHF Prinar^ Data Reduction progrm tKPRcOl is desfined to 

anaiyzt kt^points collected dyrlng t singie ^tti colltctlon «ntf 

produce syststi level ar^alysls reports* itttr it will b€ expii><l«<l 

ta tMow tli« data rec!yc€<i tc be broken out by time period for yss 

bf tlie Sxttfsdad Reporting Facility. 



The data reduction pfo^rsm wns 4#rlttan to provlda an early tool 
to rtdyca keypoint data In order to give sowe statistics to 
support performance -allocation ind softwtra deveiopraent for the 
CYBiR 180 and to forfi a base for long term reporting software. 

KP«£0 oyrrtntly runs In 170 state under HOS versions 1 and Z* 
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9.5 *>R|HA^Y 04TA RSDUCTION CKPR5D) 
^*1 KPR-30 5S,1'"RAL OeSCRIPTIOt^ 



9.1 E£IEi.a£i££4L.IIIii;ai£IIQti 



Tlie keypolnt data reductlof^ proiraw redycss J^eypolnt data 
gatharad ffo^i tli« N0$/¥£ oparttlr^g systt?^. K«ypolr^ts ^yst fee 
procasssd tsf the k«3fp©lrst pre-proeessor prsvloysly descrltosd 



Tht f<P8E0 proiriifi Is a tr«s-stf«0tyrti# fflodylar program ^ifiicli 
reads ttis pre-procassad ksypolnt file or#tt«d fey tlie ksypoint 
pre-proctssGr and syiMarizts systaii! leyel statistics from this 
data. 

Kaypolnt I nstryct I ons are d i sseia I nat#<f tftroyglioyt tiit optritlng 
system.* prodyct set# and yser code. Classes and Keypolnt oyptsers 
m% ystcJ ta Identify ynjqytnass of a kaypoint* $®« tfit S1S/18C 
for fyrtfiar details of this stryctyre. 
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9,0 ptiHMf DATA mmciim IKPRED) 

9*2 PR0GR4H DiSCRIPTION 



9*1 gmmm^mu&iiiim 



IkB prograii tits bsen written witli tlia aiii of satisfying tMo Icind 
of custofflarsi systefs d€velop«eiit and systew Per f orpam-ce* Thus* 
ttia proiran h«s t>a«fi inslfnaii to tiavt i cowiiort diti gatli€rlng 
core ^ith expaiislble data statistic ltyars» 



9.2.1 04TA G4TH£tIIIG 



The coiifion data iathtrloi core is compostcl of s Sirg« 
3iy 1 1 i -ro otsd tree Mhera leaves represent pertlnant Inf or»?!atl oo 
for Idtfitlfltd keypoints. 

In figure t.l.l tlie strycturt of the tree lililcti ktaps ksypoint 
Infomatlon is shown* 

Oyniiic .illocttion is ystd to allocate space only for different 
■keypoint ny?!il)€rs (i.e. spies Is dirtctly proportional tc the 

nyinber of different keypolnts and not the ny^sber of collected 
ksypo ints J . 

The basic structyre Is composed as foiloMSt 

.: A pointer Croot) to each sectloni systesi^ proilyct and user* 

• An array which contains the description of all the 
different kaypolnts. 

• An amy which contains per etch sub-stctlon Cor P'Bt every 
block of iO keypo4nt nyfRbersH a pointer to the first and 
last allocated keypoint block for the sub-section (If any). 

. A keypoint block contains uniqueness information to 
Identify lt| counters nnd vectors used for the histograms 
(dynawilctily allocated If re-^uasted)l a pointer to the next 
block C If any)! a pointer to the first and last data block 
Clf inyJ iihich mm^s gathered *<lthln the keypoint nuinbar. 

• A data block contains the. data Itself? a count for the 
data* a pointer to the next block Clf any)> and a pointer 
to the first and last dtta keypoint block (if any) *«hich 
would be the next following keypoint with no keypoint 
ident I f i cat i on. 

• ,4. data keypoint block contains the data.* a count and a 
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9.0 PRIMARY OiTA iEOUCTION CK?REO) 
9.2a DATA SATHERIHG 



pointer to ttis r^txt block Clf tnyl* 

Task Informatics Is kapt In i iink list reprssenta t ion • 

Only existlrsf tasks mI 11 yss sPace* 

Unit Cdisk ynltl Inforattlofi is kept In a link list foris 

Mhere only existing ynlts viMI hi^e space allocated* 

Tables for different sufswary Irif or i»at Ion are dumped tvtry 
spaclfltd ti«# }nter¥if to ttia su?iiiary fife. 
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FISiIRE 2*1«1 - Tree Stryctyre of the Ksypolfit Infomatlon 
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9»Ci PRIHAiT DATA R€OyCTION (KPRiOl 
9.2,2 DATA STATISTICS 



9.2,2 DATA STATISTICS 



i^ost of the statistics irt cofflpyttd by walking throyih tli« tre« 
stryctyre and collecting yssful data to be ysed for co«!pyta t lcri» 

An ln4Bp%n4^nt sptcl it stction hts b^en 4%fln®4 In ordtr to 
collect data to prodycs perfcrniance reports. This sect! en Is 
t^pansibl® acccrdlrsi to nutils sinsa k«yj>olnt nynitsirs are 
hard-codled « 

The need to hard-code these keypolnt nuiisers Is ittrlbyted to the 
ftct. tlitt ttitse reports nttd racognltlon of tv®nts Mfilch involvt 
se^utnce of keypolnts Cor a single keypoJnt) that have to b« 
Idantlfl td and trapped tJirouff? ona of tlitst special procfssts In 
order to generate the reports. 



Control Data Private 



■9-7 
?«rforfflinc« Reporting f^icMlty £iS 

24 feb 84 

9«2.3 STATISTIC OUTPUTS 



9»a*3 STATISTIC OUTPUTS 



Stftfi! fonts of oytpyt ar« geiieratscl nocortling to seieotion of 
Input togglts {A9 B, C# 0* Ef H, 4f Kf L$ N# k» $9 T , tod Xl» 

mmmi 

The summary stitlstlcs ar« gsr^trited axcluslveif by keeping 
accoyntlr^i for eacli l^eypolot* they InclydaJ 



- El ap s 6d time* 

- Total nyfuber of kBypolnts* 
Ktypoint frtqytnsy. 

- Syiifipary per «acli syts-sas tion? number of keypoint an<J 
aversges. 

- To til r^uJibar of keypolnts by class. 

TNIs output Mill alleys be printed even with all outputs 

ij I s a s 1 1 y st e d • 

This neiiis only Ktypolnts of clissas 0~5 art tnalyz@c!« 



Only ktypoints of classes 6-10 are analysed. 

Only key points of classes 11-14 are analyzsd* 

Sy default til k«y points are Jdintlflsd. 
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9. J PRI'MARY D4TA P^OUCTIOH CKPRHO) 
9.Z»3 STATISTIC OUTPOTS 

Tills if^f ofiiatl on is gathered ysing tNe data fl«ld i^lthlo the 

keypolnt number Mn4 tht 4nt% kmypQlntm Th% printout will b% for 

each section and for eacfi different keypolnt If data exist. The 
oytpyt #< i I I contain* 

Ke.^Polnt nima and nypbsr* 

-- Data content and tilata keypolnt content* 

- Counts and per centafes* 

Followlnn ^s an txanpis of ttia oytpytt 

pumt BUFFER mm sva count i-cooht 

4F0 3 10.26 DAT4-K:PT COUMT I-COUNT 

8 1 12*50 

1008 1 12.50 

2008 1 12.50 

3008 1 12. SO 



Kpt.^nawe Content I of ocourrsncts I within th€ 

data field within the sub- Hpt. no. 

section 

KPt. no. Occurrences Content of 

Hnmrn of data kpt. 

the data field Occurrences 
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9.0 PRIMMY' Bklk kmUtllQH iKPmO) 
9*a«3 STI^TISTIC oyri^uTS 



-•ii*9« «>«» Aft &>M> 4d ia»4i> 

Inform^tiwB errors are printed to Niarn the yser that soiethlog 
ii d riot f0llo*i til rylts iovtrnlng kaypoint st<|y®nces» Folionifig 
Is an example of an error wessafeJ 

32770CI1 .lit* Procedure aotry/sxlt not In sequence* 

Kpt* tlfit «rror no* trror d^scrlptlof^ 

st aiip 



The tiffle staw is printed bscayse It has uf^lqyeness aioog all 
otiitr fitlds thys Icftfitifying th« ktypoint Mithout iwfelgylty 
since no ti40 tint stamps are I dent leal* 

A sy^iiary ttlsle slioMing how fsany errors of which type Is also 
prrnttd at tha and of th« run* 



For stch identified keypoint three hlstogra^ss are gensratedi 

Keypoint fre^^yency* 

- Tims to n%nt procedure call Cor next occurrence of sa?ie 
keypoint). 

TlPa between entry/exit of procedyres i^t^%rn sntry tnd ixit 
kpt. Bf % specified). 

L - Histograni for Last Call (last occurrence) • 

N - Histoirt!!! for H«xt Ktypolrit Cfr^quency). 
X - Histo^rau? for entry/txit of procedures. 



Thys H Includes ill histograms. Hoy*%w%r l# H Mnd X aff«ct only 
the corresponding histograms. 

A samplfs hlstograi?? output Is shoi<n In the Output Reports section. 
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9.11 PRI«ART DATA REDyCTICIt^ CKPRE9) 
9«2»3 STATISTIC OyiPUTS 



For «ieli task in tlie systtis ttie following data is prodyced. 

- User time in microseconds ^nd as a percentage of the total 
tisk tint. 

Wor^ltor tliie In fplcrosaooiids and ss a perctntis^ of tlie 
total tasN time. 

-■ Tatil tl ma.f psrctnt tgilnst total, run. 

Chronological order of tpp®«ranc« for all ksypolnts Mltli 
counts and per centfgesl 

Total tnd ptrcantages for th^ entire rum 

- Sefffltnt anil pagt faults information* 



ThB K toggle Is ysed to print a kaypoint suwrnary t>y task* 

Tiia NOS/Vi monitor «xlt keypolnt {nunber 4001) Is yssd to keep 
task iccoyntlnp» 



FolloMini is an example of tlie oytpyt* 

Task no. User Tltit % m MTR Time Z nn TOT. Tiiiie f 

Tipe 

21753 43.44 ^1038 32.86 4E781 37.50 

* 

Chronological or-^ar if selected (K toggle) 
Segjuent mcl Pagt ftylts Information 



T0T4L 50073 43.90 63997 56. i§ 114070 IClS.Oy 

DIFFEt 50073 0.00 bBZQ3 6.17 114070 0.00 
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9. CI PRIHAif DATA RS0UCTIOH CKPRiD) 
9.2.3 STATISTIC OyiPUTS 



a: 



KEYPOIi^T 

% TASK I TOTAL 



pemSsttrt^stop^Kpt 

milosttt spic« in ^«tp 
t 


1 
9 


0.47 
0.94 
4.2S 


0.17 

. 3 3 

1.50 


s 

TaT4L 
OlFFfcR. 


601 
1 




99.83 
0.1? 



The lint f^aa?0i "OIFFSfl*' Is a checkpoint sun Mlilch is able tc 
verlf3^ If the accoyrsting Mas kept accyrately. The *•!*• shOMad 
unisr tfia kiypoi?^t ooyrtt Is ciussd fey a ftylty ktypolr^t ^fiich 
gave ai^ error condition* thus It Mas not r«cor«le*l» 
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9»0 pmnmt^ data mmcriQn ckpreo) 

9.2.3 STATISTIC OUTPUTS 



This oytpyt shoyld give tlit per f or siai^ce avalyatlon report* 
H9Mt¥«ff sifics Host of tM k^fpolrtts ara rsot aval libit toprcdyo* 
sucli a f yl ! report* oni^ a sfiall syfeset Is feoarated. 

- CFIJ IJsiig« Cp€f each CPUM 

• N^ tliPt with pirc«ntsit.# 

• UH time with percentage* 

• : Total CPU tlit.» 

• Hil/SM <jo?iip«r Isori tlists* 



sypolnt #40©1 Is ysed to keep tti@ CPU tliaa accoynting* 



- fitiiory Htnsi@r 

• To til page faults /sec. 

• Page faylts/sec« with I/O. 

• r Piit ftylts/s«c. withoyt I/0# broktn down into* 

« nsvi paies* 
« reolainssclf 
• others • 

Kaypoirst #1106 Is ysid to keep accoyntl ng for the page faults 



^ Pnr Ipher B.^ Deyica Usage 



« no. of I/O r«^y«sts* 

• ayg. byte transfar 

• type of reqyest Cinpytf oytpyt)* 

• tyg. I/O qytys length. 

Ho keypolnts nre available at thB time of this ypdate 
stat I sti cs. 



for I/O 



- Sufflfflary Hlstograffis 

. overall keypoint freqysncy* 

• over ill time to next proctdyre ctll* 

. overall tlise between entry/axit of procedyres. 
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9*© P8IH4RY DATA RgpyCTIQN (KPiSO) 
9.2«3 STATISTIC OUTPUTS 

For each sy|j"-S€€tl on witlilrj ttcti stction (system* pfo<lyct^ ysir)? 
a sufflfflary report Is producedi 

• Ktypolrjt r»«fflt an^ k^ypolnt fiyisber 

• Coymt* p@rc«ntsga* a¥eragt within the sylJ-sectlon» 
» Ayarage ffe<?ysiicy* o^Kt caM» and er^try/^x 1 1 • 

• ■ Total by ssctlon* ivarsitf %nd mnnimMms* 

¥qU Qwing Is an mnampiB of this oytpyt* 

IS USASg BY FUNCTION 

Kpt-nifi!« Kpt Count ICount iCoyot Awg^Tirot HtM •«• Avg.Tiflie Max 

Ho» Hodyle Total Hent Call ••• Ent/Cxt 

lSk$LOS^ASCII 050 4 10§«©© ©•d^ 4?165«a0 918S6 ^Qll*^© 211C 

4 0.66 klim.m 91856 2012.50 2110 

Syb-sect ion 



For every keypoint* on« fins of oytpyt Is prodycad ysing the 
following format i 



2348 IE 28B H PFTI 4 1222 H HM 3 D Hake paga ttbit €ntry 



tima d^ti format class* kpti sybsect. Ktypolnt dtscrlotlon 

(ysac) field (H=hex«) HH^memor ^ manager 

delta data CPU f1od« task no* 

titpe description H«jisonltor Class/Type (O^dtbyg) 
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9-.a PRI'^AS^Y ^4T^ R'^OMCTIQM (KPRS'D) 
9.3 DESCPIPTIO^ IF FILHS USED 



9.3 OfSCIEI£IIQM-Q£-£IiiS«yMfi 
9.3.1 INPUT FILES 

INPUT! This file contains the prisgraii input para?isters <togglesl. 



FKPDSj This file cor^talns ttie description of all the keypoints in 
tlie data fils. It Is the first record of the data fits KPTOFL 
which Is an outpyt file from the or e~pr ocessor program KPPPS* 



FKPOTs This fll« cor^talns the pre-orocessed kefpoli^ts. It Is the 
saconci racorci of the output fila KPTOFi genartted by the 
Pre-Pfocesor program KPPRt* 



FKPOOi This file contains luf ori!?at Ion for data statistics 
racorrflns* This reduces the ryntine CH usage considerably ^hen 
used corrsctly. Thi fll« foriitt 1st 

Class Kaypolnt (for delete) 

this meun the data will hot he recorded for that specific 
ktypQlnt ♦ 



9.3.2 OUTPUT FILSS 



OUTPIJTJ This file' contains all the selected outputst tracer 
hlstograais* sumiary reports.* tiata statistics* etc. 

FDEBSt This /file contains a swall iiiount of dthugglni Informitlon 

Mhlch keeps tracks of the logic flow of the program. 

FKPS^J This file contains sammBry Infor ?i«at I on per selected tl?i!s 
internal for the I/O^ System* ffeiiory Hgr.# Task H§r*f etc. This 
file Hill bB used as Input hy the suiimary reports generator. 
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9.0 PRIMARY OATA RiOUCTIOH IKPRED) 

9.4 OUTPUT mpmrs 



9.4 omsii-iffum 

9.4.1 KSTPOINT TRACg 
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imE ■ 
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n sc 
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DATA 
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X 
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£ 
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g 
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93 


Q 
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STATUS 


3 


1617 
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i 
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217 
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1647 


y pn 





i 


P^PSTASK 
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6 





I 
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3 


1647 
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B 


X 
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1617 
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f 
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STATUS 


3 


1617 


y pn 


CI 


X 
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ZD^S 
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y p« 





E 
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STATUS 
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PHPSESTA 
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STATUS 
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«>HP$£STA 
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I 


STATyS 
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U PH 





E 
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290 2 
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STATUS 


3 


1617 


y Pi^ 





X 


PHPScSTA 


3017 


155 


80 


H 


nm 


■3 


4004 


y m 





X 


£XIT JO^ 


3079 


22 





H 




3 


250 


U CL 





X 


CLPSPROC 
3C79 


3260 


lai 


CI 


H 




a 


283 


U CI 





E 


CLP$€iT. 


3424 


164 


10 


H 


FIO.ORD 


2 


119 


u m 





£ 


AMP$GiT^ 


349 8 


74 


10 


H 


FID.QRO 


2 
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U BA 





e 


8.^P$SYS. 


352S 


23 


10 


H 


FIO.QRO 


2 


171 


U 8A 


§ 


E 


BAP$€ET_ 


3810 


ZBl 





I 


STATUS 


3 
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y BA 


Q 


X 


8AP$G£T_ 


3821 


11 





I 


STATUS 


3 


199 


y BA 


§ 


X 


6AP$SYS. 


383 3 


12 


a 


I 


STATUS 


3 


119 


y AM 





X 


AI^P$GET« 


39^5 


9Z 


■ 10 


H 


FIO.QRO 


2 


112 


y m 





€ 


AM?$F.£TC 


396 3 


38 


10 


H 


FID.ORO 


2 
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€ 


SAPSSYS. 


398 8 


25 


10 


H 


FID.OiO 


2 
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Q 


E 


AI^PSACCE 
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46 
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I 


OP 


2 
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y 3A 
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€ 


8AP$CGHT 
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10 


H 


FID.ORO 


2 


165' 


y 8A 
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4113 
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I 


STATUS 


3 
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y BA 





X 


8AP$FETC 
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1 


STATUS 


3 
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y 8A 





X 


8AP$C0NT 


4132 


9 





I 


STATUS 


3 
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y AH 





X 


AHPSACCE 


4141 


9 





I 


STATUS 


3 


199 


y BA 





X 


8AP$SYS« 


415 3 


12 





I 


STATUS 


3 
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y An 





X 


AHPSFETC 
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H 




3 
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# 


X 


CLPSGET. 
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4A^nL^^ 
''H*^^'^L^'> 



MDEFIHiO KfYPOI^IT ** 



VALUE 

QLOCK.^'^ACK 
BLOCK.ST^CK 
TtA^ W4*4DLEP 

8LIS^«C0*^f)ITTn^J_ 

BLI^H.CONDITIO*^. 
BLl^H.Cn?4^ITinN_ 

SLISH^CO^OITTON^ 
9LI^H.rnNOTTI0N^ 
8LI5H_C0*^0ITnN_ 

SLISH.Cn'^OITin^^ 
eLISW^COMOITinM^ 
SLISH^CO^DITION. 
iLI^H.C^^lf^lTI^I'^. 
BLISH.COMOITION^ 

TI^AP Htf^OL^R 
ESS.CON*»AN^ 

.117, H'M »tOCK 
OATA^LIHf 
N£XT..KiY 

iLK_VA^IA8LE.tEC 
NEXT 
NEXT 

BLK.¥APIABLE.R£e 
NiXT.KEY 

H.ACCfSS^INFQPHA 
8LK_¥APIA8L5.R!^C 
SS.HFTHOO 
POL 
H^ACCESS.INFO 

hIaccessIinfo 
pgl status = « 

SS_^?€THOD 
8LK_VARIA8Li^RfC 
H.ACCFSS.INFOtMi 
OATA^LINE 



WITH ctlT 



'k^ 



Tim 



lOl^f^AL 



^F AP 
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9*4*2 ERROR Sy«fiMY 



gRt-NQ ERROR MESSAGE 



104 
111 



KEYPOINT MATCH .NOT FOUND 
Cl>0 STATE OUT OF SEQUENCE 
PROCSOURE EXIT HOT IM SSaySMCE 



coyHT 

26 
4 
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9.4.3 KgYPOINT Sy«HAtf 



CaNTtOL-TOS€lE$ ClHT iUN-HO. 
TOTAL-KPT 13534 KI>T-Fl 



99 START-TIHS STOP-TlHg 

MJ^^CY 40§5.65 USSC Hi-BUFS 



54212§33 flAPSE0-TIH5 
■0¥Fi 1 S«-SUPf=-avi:t 



CUSS COUNT 



15 



6&3'2 

6646 

1 

132 

114 

3 



I- TOT 

0.04 
4*^.0 
49.11 
0.01 
0.98 
0.^4 
0.02 



13534 100. JC 



SCTN-HAH:E 


COUNT 


PERCINT 


m 


C 103) 


512 


4.23 


Bk 


C 150) 


931 


6.88 


BA 


( EOOl 


2 


0.01 


€L 


C 250) 


20G7 


14.83 


m 


C 400 1 


li62 


T.85 


m 


C 45;)) 


lly 


0.89 


IS 


1 85-^1 


8 


§•06 


m 


CllOO) 


514 


3.80 


nn 


(1150) 


174 


1.29 


OS 


C14uD) 


292 


2.16 


PH 


C1600) 


846 


6.25 


PH 


(1650) 


5 


0.04 


ST 


(195.^) 


8 


C.§:6 


JH 


C19CiO) 


508 


3.75 


AV 


(ZIO^) 


a 


O.Cl 


10 


(22001 


284 


2.10 


RH 


(2£50) 


34 


§.25 


NT 


(.400D) 


5893 


43. S4 


FC 


{ 250) 


10 


0.07 


CC 


( ?50) 


236 


1.74 



13508 



99.61 
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9. J PRm^ffY lAT^ REDUCTION CKPRgOl 
9,4.4 SrSTI-l SUI^*4Aiiy 



9.4.4 SfSTlH SyHMART 



^T 



CPU USAGE 



aO Li; 
TOTAL 

UTR-MODc 
US R -HODS 
ITO-flOOS 



17>) HODE 



54212533 100. OOt 

54212533 

5070T911 93.541 

Ztl33QB 4.8af 

889114 I. 641 



HtkS 


FR£aU£HCY 


AV6 


.out AT ION 


lZd9 


4ai}S7.32 




39338.95 


1290 


42025.22 




2027.53 


1275 


42519.63 




697.34 


35? 


1518^5.83 




497.38 


24 


2258855.54 




76766.42 
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9,5 l>iI«ARf UAIA REDUCTION CKFREOI 
9.4*5 PASIHS SyWIARY 



9.4.5 PAGING SUMMAtY 



IW 



PAii FAULTS 



a/s 



USER 



PAG£ F4yLTS <I/g) 
PAGS FAULTS C^O I/OI 
RCCLAI^SD 

?T FMLL 



PER SiC. 




cgyMT 




PiR S£C. 


3,8? 




210 




0.00 


l.Ti 




95 







t.12 




115 




i' 




0, 


,46 


a^ 






1, 


,SS 


84 









• 11 


fe 





O.QC 



COUI^T 



C.C-O 
C.C-0 





TOTAL 




pm s?c. 


coif 




3.8? 


2in 




l.?5 






1.12 









».45 







1.55 







O.ll 
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^•0 PRIHAJ^f DATA RSDOCTIO^i CKPRiD) 

^•%»6 TASK Hhnm^R sunnA9.i 



9.%. 6 TASK HMi^GER SUHflARY 



tn 



TASK H.INASiR 



CPU 

TASK SWITCHES 1290 

TASK SHITCHSS TO SJIHS T4SK 1267 

T4SK SHITCHiS F^tiQUiMCY 4ia2S,22 
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9.0 PRI^A??Y ')4T4 R-,OiJCTIOH {Ki>BW) 



9,4.? COM^OH I/O SUMMARY 



10 PEklPHBUAl . DEVICE USAGE 

To ba supp I led» 
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9.0 ?^fHARf i)4TA RtOllCTIOH (KPR€DJ 



9,4,8 HISTQ€IIAI1 EXAMPLE 
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TOTAL y-i^^is 

TOTAL X-AXIS 2 

nm PE4K x-ixis 

VARIANCE 9.30296294 
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?j A X X — /^ 
A¥€RAGE 
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9*4*9 TASK STATISTICS £KAHPl£ 



f.4.9 T4SK STATISTICS EXJHPIE 
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QUEUE OUSUE IN«PT HSHQRY 10- 


-AC TV ON 




3 










F 


10 







11 


I § CI 







3 


3 







10 


10 







28 


4 







2B 


1 § 







3B 


S 


§ 




8 


10 







3C 


10 


€ 




IC 









PAGE 
■DISK 






14 
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I-TOT 
2*70 



COUNT 1-TASK l-FOT 



77 


14.^.^ 


0* 


8 


1*47 


0. 


4 


0.'^4 


0* 


4 


"^.-^4 


:^. 


4 


■1.^4 


3. 


51 


'5*3-^ 


0. 


74 


13.63 


0. 


3 


0.^^ 


^. 


12 


?.?! 


n* 


4 


^.^4 


0. 


46 


^.4^ 


0* 


16 


?,05 


0. 


12 


?*21 


'^. 


18 


^•^T 


0. 


4 


0.74 


0. 


5 


0,Qi» 


0* 


14 


z*5n 


0. 


6 


1*10 


0. 


6 


1.10 


0. 


2 


0.^7 


0. 


4 


0.-^4 


0. 


2 


0.^^ 


0. 


2 


^^^7 


0;. 


43 




%• 



PT-IS PS. 10 
FULL ORV.REJ 






^.4G€ ^IL.il 
1 
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**PAGE TABli IS ryil*^* 



1 1101 Ptl 



l>ASE IkBLB FUil PRHCSSSIR 



PASE Tl^ilE PUlf PiOCESSOR 



DELETE SEGHEHT 8Y SEGHEHT NUHSiR 



OELETg SEGMENT 8Y SBQmm UmBER 



FR£S ^AS€S 



Z 1146 PTI 



3 1146 PTI 



z iim 



3 1105 



2 1104 





COUI^IT 


I-CQIIHT 


843 


1 


16.67 


S45 


1 


16.6? 


see 


1 


li.6T 


F87 


1 


16. fe? 


FI8 


1 


16.67 


F47 


1 


16. 6T 




6 


im^m 




COUMl 


I-COUHT 


814 


1 


l&.fe? 


826 


1 


ia.6? 


i9C 


1 


16.67 


F98 


1 


16.67 


F8C 


1 


16.6? 


F28 


1 


16.6? 



6 im*m 

COUNT l-COUNT 



83.33 
16.67 



IZ 



t 100.00 

COUNT I-COUNT 

2 IOC. 00 

COUNT l-COUHT 

2 100.00 

COUNT l-COUHT 

Z 100.00 
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9*4»ii SBCTim smnAm 



USA6E sr pymcTiaHS 



KPT^NQ COiJMT I-COUNT I-COUMT 
MOOUIE TOTAl 



KPT-HAHi 

1106 420 81.71 3*W 
SET/SST SEGHif^T liHSTH HOHITOR RSaUEST 

1142 32 6.23 0.24 
**?>4Si T4 81S IS FULl*** 

1101 6 1.1? 0.04 
PiRIOOIC CALL 

1136 16 3.11 ©.12 
PAm T48Li FULL PROCgSSOR 

1146 12 E.33 0.09 
OElgTE SESHSfll 8Y SESflENT flUHSiR 

1105 24 4.6? 11.18 
FREE PkmS 

1104 4 0.78 0.03 

§14 3.80 



AVS-TWi 


nh% 


EXT-CALl 




HIiLISiC 




29459.04 


54042 


193m. m 


51958 


8232.83 


18405 


32370.00 


49396 


33234.83 


49396 


P1649.58 


53258 


51953.00 


519i9 


£9735.83 


54042 



¥G-TIHH 


nkt 


EXT-KPT 




ICROSSC 




326.56 


4555 


146.69 


550 


248.83 


377 


55.19 


100 


984.17 


2603 


393.8? 


2686 


157.25 


313 


323.19 


4555 



5^ Y f» O rj <% c 

2645.7 
485.5 
0.0 
5310.-^ 
6898.1 
2048.'6 

2647. 4 



Cofitro! Data Private 



f«rf©riaoc8 Riportiog Fsci lity EIS 



Zh Feb 84 



• 4a2 INT-^VAl SUiiiARY FILi 



9*4. 12 IHTSiVAi SUHH^RT fllE 

10000 
%KriQ 9812 § 253 9128 252 510 259 175 ^+-i.+K + 9«« 0995StS8llH 



1900 


1^502 


D 


240 


240 








4000 


2<>23a 





2S7 


8946 


257 




6C6 


ilOO 


29238 





19 





a 







i9iu 


2923B 





257 


257 








4000 


3 9212 





241 


9196 


241 




624 


11 DO 


39212 


C< 


lb 


Z 


i 


§ 




1900 


39212 


y 


241 


241 








VOOO 


48674 





122 


915S 


122 




191 


1100 


48674 





50 


3 


2 


a 




1900 


48674 





122 


122 









y 



1^1 
218 154 



138 94 



37 






32 


16 





11 








36 


IS 





IS 








80 


44 





6 
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9.i Pnnk^if D4T4 R5DUCT20H <KI>ilEDI 
9*5 0?S??ATI0n|41 PROCiOURES 



9,5 i£££ii:ifiMi-£EI3i;EayEIl 



To Install this profrai» tlirea filts are nee^adJ PH¥?lf XUIIS arsd 
PHFPII8. To compllt aod stvt tfi# binary of tlie tiata rtcfuctlon 
prografP types 

SES.PflFIHST KI>R£D 



9.5.2 04TA tSOUCTION OPTIONS 

To run the data reductlcr progrnmi 

MPRBOf Input fQutputff4Bb§» fkpds* f kpdf > f kpsP#f kpdd* 

liipytJ TGI RNQ $KI> SKC MSR HOT INT SCT 

i*h B r @ t 

TGls program control togilts C^iCDEHJKLNtSTX) # 

PMQt run nypber* 

flKP? iiaxlmysi nuffiber of ksypolnts to process* 

$KP I number of ktypoints to skip at the beginning of tii® 
ka ypo I nt file* 

SKCii start k^ypolnt cl sssf 

HOT? ma ^ I mum nyuBbar of data lines to record* 

M£R.« ?iiaxifflum number of errors to printed* 

IMF? sy?!iitrlas inttrvtl In itsllilsac.* 

SCT* only kaypolnts mith this section number *< H I foe printed In 
the trace. 

The Input Piust follow these rules and/or restrictions* 



all the Input paraweters are optional. HoHever* If the Ith 
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9.5.2 D4TA ^IDUCTION OPTIOI^S 



para«©tsr Is specified* all Ills Predecessors must also be 
pr «s«?itf 

toy nyiiber of fel®f^lcs can prtc^ed or follosii aacli of ttie 
tofcsus of the input* at least one blanl« has to ^pp^bt if! 
■fo«tiftsr> %M^h tokai^* 

If ttie Inpyt file is &mptf ttie folloMlni dafaylts are 
assyfitds 

. ill oytpyts if® printed CTGl ~ €>)* 

« the run nyafoer is e^ual to ^aro ?RHQ = 01* 

. all keypcints are processed CHKP = -1)* 

• no ktypoints are skipped it thB btilnnir^g of th« dit« 
f i le I SKI> = CI* 

• the start keypoint ol ass Is 15 CSKC = IS)* 

• up to 1000 errors will fee printed CHER = 10031* 

• yp to 100 4^t%. fitlds will be recorded <MOT « l-aO* 

• no suii«ary will be processed CINT = -II* 

• the trace mI I I print all key points belonging to any 
section CSCT = 99991 • 



TGI (optional I* ttia proiraii control toggles consist of a 

string of characters ik throygh Z)* the string ii«y hi 
eipty* 



RNO {optional)* the run nyi^ber Is any positive Integer of 
six d I gl ts or less . 



HKP (optional)* the mBximMw. number of ksypoints to process 

Is tn Integer which follows these rulesJ 

. = no keypolnts i«lll be processed* only the PHF 
counters statistics will ha printed (If PHF counters 

are present in the data filel* 
. n - only yp to n keypolnts mI I I be processed* 
« ~n « process «M keypoints* 



SKP (optional)* the nufnbsr of keypolnts to skip is en 
integer following these ryles* 

* « do not skip keypolnts* 

* n * skip up to n keypolnts at the beginning of the dat« 

file* 

* -n - skip all keypolnts* thus printing only the ?Hf 
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9,0 PRIHARf OATA REOUCTION CKPicDJ 
9«5.2 OAT^' RSOUCTIOH OPTIONS 



coyr^ttrs stitlstlcs Cif PHf ooyritsrs ire prtsspt In 
the data file)* 



'KC foptlonal)f. the start 



keypoifit class Is an ifittg«r 



♦ = start i^itt^ amy class 

• n - start redacli^g Mith the first kpt. of class n* 



HER Coptionall^ tills parameter allons tlie yser to limit the 

number of trrcr «i€ssagss to l?t printad* Tlhs trror syiisry 
talbe Is alMtys active* regardless of th« vaiyt of *ltR or 
th% toi§t« •£♦« 



-r^ - 



has ttie sifB« affect as toggle 

passages. 

prints up to n trror si«ssiig«sj 

ali error mcsstges ara printed. 



tst 



no 



trror 



HDT CoptloniHf this Ptr««ttar linlts the nuiPlstr of diti to 
be recorded. Tills reduces tf^e ryntla^e maiRor-y usage. 

• * do not save tny dtta^ tiius the sawa effact as toggle 

• n « save up to n data Iteis for aach keypoint.* 

» -n = sa¥e al I data* 



|?>IT CoptionaD* this pirtmttar tilow tht ustr to sti'i9 on a 

file (FKPSH) su-iiary Information at specified interval 

(illllsac»3» This file Mill bs ysed by the suwiary raports 
generator. 

. n = dump su«5B!arles every n ml I i iseconds* 

• -n s: iio not dufflp suf^uiar las. 



SCT Coptlonil)f th% section nyjuber Is tn integer <»iltli up 
to four digits) which pay be equal to any of the section 
nysibers defined in the keypoint description file* 

• If no trtca Is selecttd* this piriiister is ignored. 
. If specified with a value of 9999 ail sections will 
be printed. 
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9.5.3 ?ROSRAH CONTROL PAiAHSTERS 



Tl^t dttt fg^yotion prograffl l^as been provided with several prcgra^i 
control tofilas. Ttitst toiiias i«li I ietctivate parts of tiie 
outPyt if selected. 

Bf dtftyft til iilfftrant oytputs are pririttdi If any oiie toggle 
Is setf It dessltcts tti€ corrtspondl ng oytput. Tiia follo^lrsg Is 
a brief description of these toggfest 



»SfC« deselect proeessing of systasn* pro<|yct set> or 
ksypolnts resptot I vsl y. 



user 



t 






Si 
TJ 



deselects the dttt output. This oooslsts of statistics for 
the data values Clf any) iathered by keypolfst i^uml)er. 

dsstlects non fatal error nessages* 

dtsalscts til t^lstoirifis oytpyt <thys It Iwplits Ip M and X 
ai so> » 

deselects task statistics* 

d!«ssl«cts t«sk keypoint descr Iptior^. 

deselects Clastl filstogrtiis for frequency of caHs for a 
specific keypolnt. 

deselects (Next) fiistograi for frscjuency of a specific 

keypolnt. 

deselects the report I fifor?»ist I on Mhlch Includes* CPU ysege.* 
puge fault statistics* peripherals device usage and su^eary 

histogrtjus for each histogram type. 



deselects syflu^try output. This Is 
section of the operating system. 



1 su?imary of tvery 



deselects the trace dump for every keypoint. 

des^Mcts <entry/eKlt) hlstograiss for average 
times of selected procedures. 



ntry/txl t 



If til toggles are selected* only one oage of output ■*«*lll foe 
genarttad. This consists of a very concisi sufipary Includlngs 
elapsed time* total number of keypolnts* overall frequency* run 
number* keypoint counts for every section* etc. 
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9«c; PRinmr nkih reduction ckpredi 
f.5.4 K?mo m^^ pmctom-^s 



9,5.4 K^tEO RON PROCEOytES 



kn SES procedure is pravldad to 
da so r I foes t h% pr oc I n d e ta i I s« 



ryfi K?l?iO-» Th« following 



^ny of tn^ pir^wetsrs dsfineJ In tti« $2S nodule JOSPARh mny be 
usei. TH*st Include 408Tl# J36^L# JIBCI* JO^Pl(# J-lBUNf JC?Py* 
4'3Bi='iLY> JCBCN* J08PN# LOCAL, HkJCHH» ^ATCH* 0£F5R> NOO^YFf 
}3AY^ILr> 4i0 DF, (See S£S ?*roctiura i^rlt^r's Suids^ Apoendl^e Al 



TPF 



OTF 



OSF 



00^ 



RDF 



DSF 



If t.!i« pr tprocessa*! dttt Is on t«p«f TPF is us^(l to 
specify the VSNCs) of tfie tapeCs) oo which tfie data Is 
found. If tti« VSHls) hav« Isadlnn Os tfj€ VSN «ust l3€ 
sriclossd 1 r> single quote narks. If the data Is spretd 
across iiore tk§n out rtei* th© list of ¥Sf^s liust be 
enclosed in parentl?asl s. Up to 1§ rseis of tip« la^^ fee 
specified. Tapes myst be labeled. 
ExiPPl® TPF«««ili©123»*l£34S6) Deftylt none. 

If tlie prmprocBssBd data is on wass storagef OTF 
spaclflas the file nana In Mhlch tlie data Is stored. If 
0TF is not foynd* KPiEO ryns KI>PR£ to crttta ont. The 
file may be locals direct access > or even Indirect 

tocess ilthoygh the last iltsrnatlve Is usually 

I ipract leal . 

SxaJiple OTF'DATIkFL Default OiiT/iFL. 

This parametsr specifies the file nhere the. keypoint 
descriptors are found. This Is an output from KPPRi. 
EnMmpie I3$F«0SSCFL Default none* 

required parainftsr. 

This parameter allows specification of an input flit for 
rtducing the processing during data statistics analysis. 
The file format ist 

Class Keypoint D (for dalatel 

this means the data fl«ld Mi H not be recorded for that 

keypo int. 

Example DOF=OiLDT Default OATDEF. 

This ptrarsfttr specifies the' Ifn of the KPRSO output 
file. 

Sxampit RI)F*CIIT Default QKFRSO. 

This parameter specif I as tha Ifn of the KPUBB dsbug 
file. 



Example OGF-oeSUG 



Default D8SF. 
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9.0 PftlrtARV D4TA R-tDUCTiOM (KPRSD) 



SUF Tt^ls paraptttr iIIoms specification of tti€ KPRiO summ»rf 

file. 
Sxifflplt SflF«SUH«4RY Oafayit SHTF. 

TSL Tliis paraistttf allows stttlns of various progrii 

toiiles. The pemittad toiiles are AiCOf 4KllltSTX* 
£Mtf!?Pl« TiSi«8CX Dsftylt CINT« 

TIT This piramtttr slloiis sptelfying a title of yp to 4C 

oh araist-ef s« 
tnmpln T1T»«P«F iUH FOR FHO« Otftylt Pf^F I^ON* 

IIMO This paraiister allows spsolfylng a run n^mb%r Imix cf 6 

digits), 
exaaipl© tNQ«l Otf««lt 99, 

SKC This partiwttar alloHS spssifjflng ttit startinf kfypoint 

class for processing* 
gMiiipl® SKC«13 Ofifiylt 0. 

MgR This paramettr specifies ttit i>u»toer of errors to print* 

If the nunber of errors exceads this nyiufoer processing 

continues l>yt tht rt?^tlnlng errors srt not printtd* 

Exa»pla H£i«500 Default 1000 

MDT Tills part na tar specifies ths pail^u^ nyisber of data 

viluts to Siv# ptr ktypolnt. 
gjsaffiple H0T«25 Default 100. 

IHT This ptraiseter a!loi«»s the su?iw»ary data, to be dunsped at 

somt spaclflid inttrval CIn billiseconds). Howtvar* th% 
follow on prograij for forinattlng the output has not been 
written yet, Therefort» do not use this parameter* 
SxaaiPle INT^lOO Default -!♦ 

(I gnor e Interval ) • 

SCT This p^r^m^t^r alloi^s specification of Mhlch section 

ny?!iber to print. This paraisseter works In concordance 
sflth the progrti!5 toiile T {trace). This would fet used 
If only one section of keypolnts {ie.» 1500-1550) Is of 
Interest Clf the number is not the start of a section* 
'iiiodulo 50 division will foe done such that for instance 
1525 Hould print the keypolnts lSOO-1549) . 
£xaj!5ple SCT=1500 Default 9^99, 

Call sections). 
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19 



LIB 



llBim 



Nuiifotr of knypolnts to skip at ttii te«gir»olng of tht rt« 

key point file COTF or TPFK 

iKtiipl® SKP«1000 Oifiylt 0* 

j^ixlfflyffl oyalbtr of kaypolnts to process fro?i DTF* 
Eicaiple nKP^ZQQQ Oefayft 9999<599^ 

This paraietsr allows specif I catloii of the UN of tlie 
Morkspio© contalr>liig ©ertiln flits. This illons « 
sifsgl© copy of these files to 8xlst> slpplifylng 
procadyras nhmn tk-Bf ara updated. Ih^ files acctssed 
yslrji the ID paraweter are ODF# OTF and OSF. 
£Ki?iplt W^mypE9,f Dtfaylt yser's 

Hmme of file Mhere ttie object code for XKPiEl) is fcyn-d. 
Ordinarily tills partiiettr is ofotslned from tt^e ♦toolllb» 
partfieter In the user's PROFILE* Tills parameter ^loyld 
ordinarily bn ustd for testing a new version of the 
preprocessor* or for use of a specially modified version 
of tl^e preprocessor. 
E?ctf!iple llB-^milB . Default XULIB. 

Ussr number where flit specified by LIS Cifeovel resides. 
Ordinarily this paraii?eter Is obtained from the *tcolact' 

parii!ieter In the user's PROFILE* 

Example LIiyN=UHl2 Default KEYPERf* 



Some Qy^nmpies of hOM to Invoke the KPPRt procedure follo^J 



SSS..KPRSD OSF^OSFl DTF^KPTOFL 



This call will reduce all the 

keypolnts on file KPTDFL and the 
output will he found on file 
OKPRiO. The toggles setting 

ire« no user kpt.^no trace end 
entry/exit histogram only. 



SSS.KPRSO TPF=ASC001 0SF«DSF1 .. 



This cell reduces the keypolnts 
which are on tape A8C001> will 
have a run number such as the 
date 13 Dec 1982* and mI 11 
reduce only the f I tst 5000 
keypol nts. 
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10 . lliX£aiMl-£4LL-.iaMISlS-Iflfli 

Jnm Call 4r^tlysls prngr %m Is t watliod of obtaioini stttisti«il 
data aboyt prograii dynaalcs froi the keypolnts collected usii^^ 
tlis P«rfonstiice Honitoring Facility CPHFI* Tt^t data is ysed to 
recomstryct the calls Ptde by the yarloys procedurts wiilcli tisvt 
liid l<iiypolfjts Irissrttd it tlitlr entry and exit points. The 
analysis mIH only «ork If the programs b«lng snilyzfd art 
^rittmn In a structyred manner sucli as Is obtalfiad fro« languages 
llkt CfBtl or PASCill* It Mill also work for tny othar progrtms 
Mhicli US8 the dlscipiln« of perfonulng in a block type of 
stfuctyrft. Srinctirng around entrys or exits Mitli keypolnts %il I t 
syt3stant I ally reduce the accyracy of the analysis. The Call 
Anilysls proirin r«qulres thtt tt a iilnljiy^ ill task switching by 
the operating systsi siust be ksypolnted. 
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.0.1 MSCLai£Iiai«a£«£iLf^^liSEIl 



Thers are five flies associated ^Ith a ryrt of CALIAN» 
thest Mr% input fllts^ tli# otiitr t^o art oytpyt files. 



T h r s e o f 



tilt fn« contilnl^i tilt ptraflitt^rs* In tlie currant 

CALLAN thtre Is onfr orie paraiieter i^hlch Is 

This piraiittar tllOMS th« ryn to fo« t«rfiinattd 

of file is encoyotered on tha 
this parainater I si 



PAmfl Is 
¥erslof» ^f 

without ru'r^nlng until an sod 
keypoifit flit* Tilt format of 



tSCOflDS * onnnnn 



@l til 

ktyp 

ynti 

the 

niora 

stop 

or t 

time 

firs 

rac9 

aver 

th8S 

a I 90 

prop 

data 

reqii 

ifn a I 

the 

Incr 

ysed 

tlia 

DESC 
the 

optr 
keyp 
of as 
desc 
arjtr 
datss 
Bf 
be y 



sr s lei 

oints 

I afte 

key po 

than 

r tidl 

h e c oy 

go as 
t kayp 
rd on 
ags ti 
6 w a IS 
tccoun 
r J thm 
sr ^e 
r lined 
I resign 
yzsr 
luaasyr 

# SS€^ . 

* this 

fflsnory 

FL Is 
first 

proces 
«t In^ 
o ints 
sas 12 
r I Pt or 
y ^ « yp 
r Iptor 
r .12 d 
sed in 



shou 
@« 

to 
r th 
Int 
the 
ng t 
nt i 
up y 

int 
in 

WB I 

u r sffl 

t fo 

use 

y pol 

Mha 
ts a 
Hi II 

aiien 
to Z 

SI SIS 

r«p 

th 

1 ogi 
s r • 
syst 

fro 

and 

ap 

Int 

fo 

escr 



id fo 
nnnn 

pro 

8 fl 

f M 
aiioy 
h@ k 
s sx 
€ry 

S 00 

S2 i« 
s ar 
ents 
r th 
d s 
nt 

n BO 
1 so 

ru 
ts* 

ory 

y| ra 



e left Justified. Th 
nn Is a dsclsiai nun 
e«ss» CAILAN dots 
rst e^ntr a nee to a tas 
a i«l 1 1 raid from 1 to 
nt Indicated by this 
sy point flit MH%n an 
c^^&%49 Mhichever co 
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He contalnlnf the keypoint descriptors. It Is 
record of the. output file of the keypoint 
ree categories of keypolnts are recognized* the 

eypolnts frons classes 2 ^n6 3# the product set 
lasses 8 and 9* nr^d the Mser keypolnts froii 
• mthln each of these catecjorles* If a 
s luore than once* the descriptor for the last 

the file Is used. Thus* if there Is a 
keypoint In both entry and exit classes* the 2* 
rs hIII be used. The same keypoint nuf^ber fliay 

the 3 Citeforlis. That Is* there may fee three 
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the product set» 



*r instifict.* 
^nd one in 



oii« In the optritini s,yst®i^# 
;he user ke.ypoints» 



one «n 



D^T4Fl contiins the kaypolrsts nfilch are to be afialyzed* It Is 
olstair^ti frail the sf€Ofi«l loglctl rtcard! of th% oytpyt fN« froii 
the l«sfP^lnt pf ©-processor • Oolf ke^points of classes 2#3*8#9#12 
and 13 ^r% ys«^ tsy CAL14N* Any otl^er ktypolnts ura jgnor«<l» All 
keyp0l-iits.» yp to the point of antry to the first task on th« 
k«ypolot flit «r« also Ignored. 

RiPORT is ths flit containing thm sy«?«ariz«d titta for the 
keypolnt analysis* The first line Indloites tht amount of tlia 
that ««.$ fionltortd. Tht statistical data Is broken down Into 
reports for «ach task foynd on tht kaypoint file* Tiit first lins 
of the task Is a report on the task Itself. It Is currently all 
Os byt ^1 M tytntynl ly fca ys#d to hold ttsk rtlittd Inforiitlon. 
Folloi^ini this Is the report on the keypolnts In ascending order* 

T4PS1 Is a flit containing syppi ei?8ntary Inforwatlon about the 
keypoint file. It Is prliiarlly i 6@bu§9ing flltj^ fcyt It mMy ilso 
be used to dadyce Inforniatlon a^ljoyt the keypoint file. This file 

Is Mrltten dyrlng the analysis phise.# so tliat If the prograii 
aOorts» the data on this file can lead to an approxiiiate point 
i^h tr a tht difficulty lies. 
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ivv Kcrpont C411 #aiYSis tool 

10. £ OUTf»UT R'^PORTS 



10.2 mtmi^MmEi^ 



Tfis oal r tntl f z®r septrttas tt?e keypolfits sueh that statistics 
ir« kept for each task. Sach task is reported by the number 
foynci In th«i 4001 keypoint* Tills keypoint givts ttis ttsk M of 
t^a task lieloi dispatched on exit from NOS/V£ monitor. 
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i for iH osourrencts of a glyen ktypolnt 
gathered Into onB set of sufnuary statistics. 
ach of the keypolnt's lipmedlate children are 
he case of a child* only the statistics which 
yitr parent are reported. For instance* If 
ed 10 1 1 lies by S different parents.* the tlies 
called as a child Is reported In the context 
P Mlth its I :jaf8.«d I it 9 Pir en t* 8ut Mh^n th« 
a parent are reported* all Instances of Its 
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disc I pilot ©f bacayst of. lost l?ay points* ttia stack Is 
feiek*iirtl to find « littctilni antry soiitwhsrt In tht st«o 
tntry Is foyr^d* the l«iy|>olots batweeTi the current posI 
tiis fflitoli ire <ilscar4ti« This explains m^y th& two coun 
report ars so«etliies different* *»Cayrit*' Is I oerei?«f>t«d 
in trttry ksypolot Is tf^tera^ on ttia stack, ♦•Valid coynt 
incr%m€ntQ4 wlisn t proper axit is foyrid. Ttie difftrancs 
tNess tM^ Is the nuiiber cf ktypolr^ts that mbtb discarded 
number of ktypolots tNit utrt oytstindlng it tti« tnd of 
Tha keypolnts outstanding at the and of the ryn emy l»e f 
tilt and of TAIPEI iin6%r the htidlng •summary of stack Ind 
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As ttch kaypolnt Is tnttrsd* it Is lnsart«ii Into. « Mnk«d list of 
procedure rtGords* For each procedure records the I inkase Is 
such that the parent and all children of the procedure aiay be 
determined-. The procedure records are maintained such that If 
tha prosedurs Is ctllad hy ^ort thtn 1 parent than a new 
prooBdurB record Is allocited* In this »«ay statistics msy he 
gathered for each procedure In Its role as a child of different 
Pirants. A p«it faylt keypoint his thn p%n§% fault chtrgtd to 
Its parent* The tliae statistics are ' accutay lated only where 
keypolnts htye a valid exit* HoMtver.? all page faults art 
recorded* so that a page fault i««lll sho^ up for a procedurf call 
8y«?^ If It Is syhse^uently discarded. 
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111 ,3 mggkiimkL^mmmmi 

ia.3.1 IHSTALIATIOH 



To Install this program thrst f i I €s nre n%%M4i PHfPLf XUilS Mnd 
PH¥?llB* To compi iB and save tlia binaries of tli6 call anslfsis 

SiS.PNFlHST CAllAH Ca«8IHE PtlUT 



lD-,3.2 SIS PtOCiDURt 



An SES Pfostdyrt is pro¥l<lt^ in ordtr to run thB call analysis 
prograiit FoMoi^irig is tiia dtscrjptioo of al! tti« proc 

partfuetar s* 

Any of the Pifiwtttrs iJtflntd in th# SES iROdyls JQ8PARH nay be 
ysed. These Include JOBTlf J08FI, J08CN* JQ8PR, JOSUM^ J08PM.# 
JOSFHiy^ JIBCH^ Ja8l>l1,f LOCAL, SATCHHf SATCHt OEF€R# I^OOAYF* 
DI^YFIIS* ANC DF« (S«e SES Proctdyrs Mrltsr's Suid©> Appendix A) 



Ti>F 



!)TF 



igPORT 
TAPEl 



Tape nu?nb€f or nuntesrs Gontnining prsproctssed 
keypoints* If the VSH has Isadifig z&ros the VSN J!iust be 
^nclos«d in string qyotts C').. If tha flit Is t 
oiultl-reel tape* then the list of tapes ijust be enclosed 
In pirentliesls* 
EMaiple TPF^f«CC0123«, 543210) Oafaylt none.f 

one of TFF and OTF 
must be sp eci f I ec« 

Disk file containing the oreprocessed key points* 

ixsfuple 0TF*DTF1 Default none 

one of TI>F and OTF 

must be specified. 

File on whicli tht keypoint descriptors reside. 
Example DSF=0SF1 Default none.* 

required par an? iter. 

Permanent file name for the report file. 

ExaiBple R£P0RT*REP1 Default RiPORT. 

■Perfnanent file napie for the debugging fife. 
Exaitple TAP£1=DEB1 Default TAPEl. 
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FIRST 



10 



PRINT 

HOSKIT 
ifcC3RDS 

T0T41 



Mane of permanent file where I nteriiedl ate sort d 
Example FIRST=INTERM Oefaylt FIRST. 



ita Is 



If the tfi« praprocessed ke^polnt data file Is In anotNer 
ystf's tr^t ttils ptrtfflttsr iiyst bm spaclflad, 
£xtiipl« I0»I>«T2 Oefaylt KiTP€RF. 

;0H^1^>IT A title for eaeh page of^ the report i»«y be specified 
yslrii this par«pat#r« Tli« coiimtnt fiiy l?« up to 50 
charactsrs long* The string is enclosed In single 
qyo tes ( • I* 



Olspost a eopy of th# report to ths prlr^t«r« 

Ho EXIT oard Inserted In the job stream* 

If you Mish to process less than the entire file spicify 



ttii nyiibtr of resords yoy 
RECOROS«nnnnnn« 



wi sh 



to 



prootss 



Process entire file Mitliout regard to task boyndarles* 



NSySOtT This ktyMord tlloi^s yoy to obtain i rtport sortfd In 
another order without running the analysis phase of ttie 
call analysis Cthe tine consyiiing part)* Use 1 1> coding 
the saipe parameters as yoy used for the original ryn* 



SIR 



STP 



This ptraiietar allocs skipping the preprocessed inpyt 
file ynti I t given class and keypoint is found* 
Sxaiiple STR = «12 4004»* 

This parameter allows tar-iinat Ion of the call analysis 

ryn nhnn a given class and keypoint are found on the 
preprocessed keypoint file. 
SMi^ple STP«*13 4004». 



The following are tlie allocable parameters for the SORTKEY list. 
They s?yst be enclosed ulthln parenthesis. 

SORTKcY This is the keyword for the various sort options. The 

SORTKfcY options appear balon* 

KEYPNT Report Is In Increasing values of keypolnts and 

class <AI I key points for a given class coine first). 

Sxample SORTKEY^IKSYPNT) . 
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FIINCT Report Is In if^crsasing valyss of .the 2 letter 

station nBm^m (TN# 2 lattars In th% tliird coluiin 
of the report I 

COUNT Rtport Is in Increasing valyss of the ooynt of 

totr l«s to tilt ktypoint 

VCQUHT Report Is sorted in Increasing vtlue of tsttche^ 

exit Goynt for the keypolnts 

CPTIHS Rtport Is sorted on Incretslng vilu«s of CI* tine In 

the procedure. 

A¥CP Report Is sorted on increasing vilyes of averaga CP 

tlffi€ <CPTIi1£/MAT€HE0 COUNT) 

tlTIHE Report Is sorted In Increasing valuts of Rati tints 

AVRT Report Is SQ-rt^^d In Increasing order of averig® 

rtti tlffl« In tht proctdyrt 

CCPT Report Is sorted In ordtr of Incrtasing ¥tly€s of 

Chi Id CP time 

PAGSS Rtport Is sorttd in order of Increasing nuiRber of 

page faults. 

CPhQES isport Is sorted In order of Increasing ny^feer of 

Child page faults. 

DESCf? Report Is sorted witfi descriptions In alphsnyieric 

order. 

CHKfPT Th'8 children of each parent are sorted -keypoint 

order. 

CHCPT^ The children of each parent stre sorted In ord#r of 

i nor easing C9 tirae. 

Any of the SO^TKEY paraineters may he. sorted In decreasing order 
by prefixing the appropriate parameter ^Ith the letter D. for 
Insttnce* to sort sych that the highest CP tlie is printed first* 

use $ORTKgf*OCPTIIi£. 

The order In which the SORTKEY parameters appear In the list 

datir?i?ln«s **hi ch key is most significant. S!3. 

S0RTKEY=<DCPTIH£,DRLTII1*K£YPMTfDCHCI>T) ^Mi sort first on CPTIH£ 
(highest first).* then on real tl meCdescend ing)> then on 
keyoo Int (ascending) and finally on child CP timet descending) . It 
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Is suggastad tliat Mhiii sorting if^ or4BTs ottier thsn keypr>tf at 
liist cjfis of tli« minor ksys sri©yld be KEYPMT* in ordar to litv« 



all the data concern Ir^g a keypolnt to appaar 
tie rtport* 



In the saint psrt of 



If yoy i^fiiit to sort on s>m 'othnr fl%\4 thmt appears on th« rtport 
all ttiat is rs^ylrail Is to define a field tnd a key In this pfoc« 
To find the ooly»n nymber mh^rm tlie fltld Mpp^mrsf attach tlit 
fl la dtter lined by the FIRST partaieter In a previous run. This 
file ffiiy ba lnsp€cttd i^ith «n aditor» ketpinf In mlnil that th« 
1 1 ns iencptti Is aboyt 300 ascii cliaracters* Oeterffline the ccly^n 
in ¥hioh the dtslrei sort par««i€t«r lles> an<l isodify the NOTS 
lines defining fields and keys for SOt? accordingly:. 



will see tfiat the file nmmBd by the 
as a direct access flls* Tht first 
hulk of the processing tlsie^ so 
it olittined very ohetpiy hy starting 
prograii. This file Is ysed hy the 
a report sortadi In soibq other order. Any 
nymbar of reports iiiy b« ientrittd by running KPTUU'H mith th« 
HcW?'ll?T parameter and using the proper copy of the FIRST file. 



If you lns'>#?ct this proc yoy 

FIRST oarf fleeter Is sived 
oroira^» C^LIAH uses the 
iif^srent sort options may 
the program with the COMBINE 
^I^'WSIRT option to allo^ 



10.3.3 ftUHMIN€ CAll MAiySlS 



The PtaC »KPTRyrl» yses the file ^CALLAN'* prodyc^d by the 
'IHSTALL' PROC. KPTI^OH has 3 parameters* The first para^ieter is 
the nmrn-B of tht direct scctss file containing the oytpyt froi tht 
keypoint pr e-processor. The defayit nasie Is KPTOFL but any PfU 
may be ysad hy specifying parameter 1. This file is assymed to 
contain 2 logical records* The first record Is the keypoint 
descriptors. The second record is the keypoint data file. 
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10.0 KErPOX'NT CALL A?^41YSIS TOOL 
10,3.3 RUHNINC. CALL Ar^LYSIS 



cosipJtMlty of tli« i;ali pittis ii^ortasts. Tt»s etwory ra^yl r esitnts 
also Incrtase dr amatlcail y as tlit nuiwfoer of records Incrtases. 
To ryn tht 225000 rtcord file i^Nlcti *«is iis%4 for debyiiiog^ 27%K 
octal '^as re^iyirad. Wych of this i*as probably clu« to th« 
Irrtiyltrl ties In tht flit. Still* runs of 100:300 records or so 
are proatbly tha aost cost-tf f ecti vt. 

Tlie ttilrdi para«etsr is the nmme of the ptriinant flit i<fti€r« tht 
sy Pp I »iifi! r»t try If^fomatioii concerning the run Is stored. Host of 
this lr»f oriiati or* Is for 4ebumi^§* fe^t It is also yssfyl to Itarn 
about the gerieral structyra of the file. This file liay gat to be 
over 1000 prus ^n4 Is ftntrally ifispactad it th# ttriilnal* is 
there ®r s nany lines of outpyt CiTODO or more on a large keypcint 
file J. 
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ll.ll KSYPOINT QUERY Fill ANAIYZSH IKPatYl 



11.0 lilI£aiiI-tMaX«£iLi.MiLIZiS-IE£MIi 



Th@ ktfpolnt <^u«r.y fils analyzer CKPQRYI Is t tool dtsltined to 
assist In Invest I gat if^i the contents of large keypoint files* 
This Is ystful for d^feytiilf^i and for dtttriilnlnf tfi« 
ctiaracter I st Ics of keypoint collection data* It Hms proved to b€ 
ysafyi in rflsoovarlni un«xpsct©ci and ynysyi! sequtncas of 
keypolnts and In tracing abnormalities In tht dttt fH«» It Is 
d#si aned to hindtt «ny type of ksypoint file feyt is currently 
restricted to hardMtrs colltetad ktypolnts and to thn oytpyt from 
the kaypcint Pr^-processor* 

This ofoirsjni Is not a oosP-plete or fortsai lupi enentat Ion of an 
Invss t i lat I ve facility byt ritliar «as de¥«lopgd as a iebugfing 
tool • 
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11.1 E£aEI«iIlim4L-afM£I£Illli 



fhe KPORY orograjn retils the keypoint file and extracts pertlnant 
Information according to tn^ input^quMry ptramsters glv^n. Ttie 
ffrst Una of Input specifies the type of file balng analyzed. 
Addition oar^pater lints i.f« flyen In tlit for« of t sfflill <?ysry 
lan-iua^ia. No attsiwpt has besn made to i?ake tl^ls language 
SCl-t H<a. 

Ilia liip la?i?entat Ion of tht profrii his l>««n dont In such a *«fy «s 
to mnkB th^ addition of other types of ^eurlas easy Mithoyt 
distyrblng th% miln logic of th% pronrsis %n4 wltf^oyt ©Mtenslve 
changes to other areas of the prowMm* kt \ that Is required is 
to t«fci tfie nmw wneponlc to i CASE sttteient «nd th«n to §ilti the 
condition processor In the body of the ststtfiient* 

KPQRT reads Bn6 analyzes all qysry directives and then evaluates 
thtse diractlves for «ich kaypolnt %ntrf* The ^yery iinssionlc 
daterml?! es which fieldCs) of the keypoint entry are to l>e 
processtd. The iriisiiaar specification Is r I ght-recyrs I ve illOMing 
the <a^pnst> of the qyery to h« repented is winy tl?iies as ctn 
fit into an Input line. 

0ns or ^or€ spaces must sBPur^tB each token of the qwery line. 

iacyrsion Is not illowed for hintry queries such ts class §.n<l 
keypo Int nun her. 
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11. 1.1 QUiRY LANSUASE GiAHHAR DiFINITIOM 



<-^yer¥> = <pnt> I <iBfia> <n.st> 
<list> = <nst> <expMst> I <yf^op> 
<#KPllst> « <folr^op> <llst> « oyM 
<unop> = ~ • ny 11 

<inoe> « CI SS (class nuinber) 



MB I <unQp> Nil! 



KPN 
DATA 
CLKP 
CLOT 

BOVF 

CHT 

TINT 

Jin 



kaypoifit puinlbarl 

dtta content) 

k«yP0int class tni nyf^ib^r) 

ke:ypoir?t class and data contefitl 

sntry/exit asatclilr^g) 

byffer overflow) 

coynt occyrtnces) 

thia interval betMaan dyuips) 

tiffis interval) 



NAHS « Jol5 fs«f^®> conptnd* etc. 

HUM - class* kaypoint numb%r» task lif ate. 

- - not 

4 s or 

* - and 
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11*0 KSYPOINT QUSRY FILE Af^AlYZSt CKi^QRY) 

11.1.^2 qyetY' exahpies 



lia.2 QUERY gXAHPLSS 



s# L -i 3 '~' J 



4 * H 



Tliis r«i|Uist Mill print til occyrencss of classes otl^er tlian 3* 
4f ir^d 5 from a hardware collection keypolnt flls* 



CLKP .2 * 1106 

This fs*iy«st 1*111 print ill ^nnmpl^s of tli« k^ypolnt ylth class 
2 anfl kayp^lnt id * 1106 from a pre-procasssd keypoirst file* 



80VF 

Tt^ls fsqy«st i«ould oytpyt til occyrencts of bufftr overflow fro# 
n hardMara collscttd file* 



TIH 1234 * S678 



Tills rtqytst noyl d print ill kaypolnts in th% time inttrvtl 
1234 to 5678 ?!} I crosacoods In a pre-processed keypoint file* 



f rojp 
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.1#2 aiJI£III-.EfESE: 



Hkm 












Tin 1234 


* 50C^0 










0¥FI 


TI^E 


CLASS 


KPM 


9ATAC16> 


OATAC10I 




1351 


3 


289 










1415 


2 


4004 


4§§ 


li24 




1584 


2 


1617 





§ 




167? 


3 


1617 










1«94 


2 


1647 










1900 


3 


1647 


§ 







195i^ 


2 


1617 


§ 







2040 


3 


1617 


Q 







2093 


2 


1617 





Q 




Z131 


3 


1617 


§ 


§ 




2373 


2 


1617 


§ 







2457 


3 


1617 










2581 


2 


1617 










2 705 


3 


1617 


§ 







ZBIZ 


2 


1617 










Z90Z 


3 


1617 


Q 







3057 


3 


4004 


80 


128 




3079 


3 


2S0 





§ 




3260 


2 


Z8 3 










3424 


2 


119 


10 


16 




3498 


2 


199 


10 


16 




3 §23 


2 


171 


li 


16 




3810 


3 


171 










3821 


3 


199 


d 







3833 


3 


119 





d 




3925 


2 


112 


w 


16 




3963 


2 


199 


10 


16 




3988 


2 


101 


la 


16 




4034 


2 ■ 


157 


65 


101 




4066 


2 


165 


10 


16 




4113 


3 


165 










4123 


3 


157 










4132 


3 


101 










4141 


3 


199 










4133 


3 


112 










4379 


3 


283 










4509 


2 


B50 





a 




46^5 


2 


1622 





CI 




4884 


2 


276 










4963 


3 


276 










4985- 


2 


276 


Q 







OCCURRENCiS 


41 
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11.3 OP-?RATia^NIAL PROCSDURf.S 



11.3 MEEIIiaiiiUEaaCEiMEIl 
11.3.1 imiALLAlim 

To i^istali tills proiriw tiiret files are f^aeds^t PHFI^L* XIJLI8 and 
PUFPtli. To oompllt and save thn bi nary of th« <i«try prof rap 
types 

SeS.I^HFINST KPaRY 



11.3.2 Hm TO Ry« KPORY 

Tlie KP0RY prog ran «ay be ryn by tha following control cir?J cifM 
XKPOI?T* lnpyt»outPyt.>lj|nfits. 

MNsrts Inpyt - contains the ^wery directives 

oytpyt - contains tht output raport 
fornflle - contains ttue binary kaypoint file. 

U.S. 3 %m fROCEOyRg 



An SiS pfocedare c«li«d KPOiY Is «ivtll«bla to run tli« qytry 
processor elt^lier locally or as a batch job. The paraineters for 
this proc ire given foaiow. 

Any of tha par^iiettrs ?ltflntd In tha SiS modult JGBPARH m%y bt 
ysed. Thes« Include J08TL* J08FI, J08CN.# 408PR* JQ8UN> JOSPH* 
JOBFHLYf J13CH, JOSPNt LOCAL* BATCHN* BATCH, D£FER# H004YF, 
04YPILS, A^^0 OF. ISes SES Procedure ir Iter's Guide* Appendix A) 

DTF If the raw data or praprocessed keypolnts Is on lass 

storage* DTF specifies the fiia r^nm^ In ^hlch the data 
Is stored. The file may be local* direct access* or 

tyen Indirect iccess ilthoygh the last ilternatlve Is 

us y ally Impractical. 

sxafflPle OTF=DATAFL Default DATAFL. 
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11.0 KEYfOI 
11.3. B SES 



NT QUiiT FILE ANAiYZEi tKPai?T) 
PtOCEDURe 



TPr 



IF 



Or 



LIB 



llBm 



T«i>« ny«l3«r or riyfibtrs ountmining tNt nw diti or 
P reprocessed keypolnts. If the ¥SH has leading zeros 
tti« VSN ayst be enclosed In string quotes C'l« If the 
file Is i iiylti-reel tti>€* then the list of tip«s nyst 
!5« tnclosti In pirtntlitsis. 
SKtfflple TPf «C »a00123«*543210) Default none. 

This specifies the Input pafaiiater file Mhere the KPQiY 

dlf«otlf«s are foynd. 

ixaffiple Ir^PARH Default none^ 

(interactive InpytK 

This sptolfles th« file on Mhlcti tha output will be, 

written. 

BKBmpiB OF^OUT Default none» 

{Interactive outputl. 

Naise of file Mher% the object code for XKPQtT Is found. 

iT^intr i i y this par-aineter Is obtained from the ♦tool life* 
parameter In the user's PiOFILS. This perai^ettr i^ould 
ardlntrlly ht used for testing a new version of the 
pr epr ocessor? or for uss of a specially iiodifled version 
of the preprocessor. 
SxiffiPit IIB««YLI8 Default XytlS. 

User numhar inhere file specified by 118 labovel resides* 
Ordinarily this parameter Is obtained fro« the •toolact* 

a«r«eter In th« user's PtOFILS. 

fcxainple imm^UHlZ Default KEYPSRF. 



Sowe sxaeples of how to Invoke the KPPRZ procedure foMo^i 



SE3.KPQRY OTF«f<PTS 



This Hill enable the user to run 
the query with interactive 
I nput/output* However* only one 

query per run Is permitted. 
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12,y PUF COyi^TER CR£S* 221 STATISTICS IK^CHT) 



12 .0 Eii£«aayiiii.iE£i.*-£ii«iiiiiiiii;i«iE£kiii 



Tli« PHF coynttrs report fits b%^n rtnovad froia tht data radyctlan 
proffaa KPRgD for siodularlty of proeesslng and to alleviate the 
dita recJyctlon progrti from this l>urdtn» 
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12.^ ^i^ C'ln^iJiR CRSS. £2) STATISTICS (KPC?^T) 
12.1 H^Znr G5*^EPAL DESC^IPTIQN 



le.l !lEIlI-£M£EAL.O£E£iIIIII]li 



The proifti! reads In the Rag* 22 froii tlie data collected file and 

gsnerits statistics according to maclilna type and selected 
coynters • 
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12,0 f*Hr tmmiU <i£S, 221 STATISTICS IKFCUTI 
12,2 STATISTICS OytFUT 



12.2 SlillilKi^QyiEMI 



p - ?nf Coynter Statistics 



Statistics accordii^g tc th% PHf rti» 22 stt-yp tra iv«llalil«» 
Unlsss the coynt^r options ire txplicltly changed In the datt 
coll«ctlon* tfity inclydet 

elapsed tiffla 

nyubsr of Instryctlons €jetcyt«cf 

cactie hit ratio 

CPU Honltor Hodt 

r^lPS rate 

ivtrige tlitie In Honltor HodSf 

nyfflbtf of Instruct ior>s per rttyrn stttemsot* 

These statistics are cltrlv«^ «xcl«siv«ly by tli^ conttnt of PMF 

Rsgi ster 22« 
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12«§ pnf camrm ires. 2ei statistics ckpc^t) 

12«2*1 OOTPOT REPORT 
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12«2»I OyTPOT RiPi3RT 



S2 S¥L PMF RUN* K3099 

fgRFORHANCi HaHiTORiNS FACILITY — STATUS* coMTROL km cnumms 



MF-a?-IH-?iO€ESS y STOP-D£TECTiO-KP-CLASS I STQP-OETgCT£D-€OUNTgl^-0¥€iFLOy KI>-TI«1Ei-€ARRY-nHT -> 

PHF*KP-RgQljSST 1 START-ON-KP-CLASS 1 STI3P-ON-KI>-CL4SS 1 

START-KP-CLASS 15 STCP-KP^CLASS 15 

STOP-OH-C0IWTER-QVSRFLQ«-0ESISNATOR 

PROCESSOR-INSTiiyCTIOI^-JliGllNgNT 004 PR0CESS0«-IMST8UCTI0M-«i^SK 377 



SELECT-A1-4N0-81 
SEL£CT-^2-AH0-B2 
S£l£CT-^3-4N0-83 1 



^§-INFUT-SEL£€TQR 1 

Al-XNPUT-Sgl€CTOR 5 

A2-INPUT-SELSCT0R 7 

^a-IHPOT-SELSCTQt 16 



BO-IHPUT-SELECTOi 13 
Bl-INPUT-SiliCTOR 12 
BE^I^pyT-SElECTOi 3 



CQUNTei-4 

cmmm-ki 

C0UNTER-A3 



47115539 CH RiAOIOPSRND MITH CACHE HITJ 80 

328S315 m MAtlimmQ WITH CACHE I^ISS) Bl 

1531 FAS£ TABLE SEARCH MITHQUT FIND B2 

11123474 CY180 HOHITQR HODS B3 



93766828 INSTRUCTIO*^ CmPir^^--, 

677608 SSIECTEO IKtST^U^^TT^^ ^^^-^i^ 

2307S6 CH *?FAn s:q?? sS^^^^N"^ '*'A^L^ 

54212534 CHfe ^^ic^nSFCOHD 



INSTt, SKSCUTED == 

CACHE HIT RATIO * 

CFU MOMITOR MODS = 
lilts' RATE 

NO.I^STR./RgTUtN * 



93766928 

93.481% 
2©. 5181 
1.730 
138. 3S<? 
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12.^ PHF ZnmiZ^ CR£G* 221 STATISTICS CKPC^TI 
II. B O^c^ATIOiAl PtOCSDUiES 



12 .3 a£f MIIIIiii.£ii£iiMSf I 
12,3.1 IHSTAllATION 



To Install tills prograi three files are n^Q4e4i fBfPLf XULIB a«d 
ojsipp^lP, f^ soispi l« and savt ttit blniry af tlia pif coynttrs 
proqram typa? 

SSS^PMFINST KPCMT 



IE ,3 ,2 Hm TC RUN KPCI^T 

To run the KPCNT programs 
XKPCNTfOutpyt^cntf i» 

^h®r0i oiitpyt - contains the statistics printoyt 

cffttfl - conlilrjs the list rteord of th« dttt coll fct ion 
file. 



12.3 ,3 SES PtO€£0UR£ 



k SES procedure called KPCMT Is tvaHafole to run tills program* 
It Mill tytoiiittl ca tly extract the counter record from ttie data 
collection file. IhM procfitt i«lll antfelt tfit yser to ryn tt^s 
program locally or syfopit a batch job. The folloninn paraiseters 

are aval i abl e. 

Any of the piraneters defined in the SES wodyle JOiPAtH may b§ 
ysed. These include 408Tl# jaBFLf JOBCN.> JOSPR» JQ8UN* JOePi* 
JQSFIilY* JOBCH., JOBPNf LOCAL* SATCHM, BATCH, DEFER, NODAYF, 
DAYFIIE, AND OF. (See SES Procedure !4rlter«s Guide, Appendix A) 

OTF If the raw keypolnt data Is on mass storage, DTF 

specifies the file name in uhl ch the data is stored. 
The file i!?ay be local, direct access, or syen Indirect 
access although the last alternative Is usually 
lupract I cal « 
zytamplB OTF^DATAFL Default DATAFL. 
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lZ*ij ^^F CW^TJS^ CttG. aai STATISTICS CKPCNTI 



TPF 



CMF 



TIT 



lis 



LISUN 



Tips i^ywhtr or fiy«btrs cor^tilnini pr«prociss«d 
ke^polnts. If the VSH hits leadlnn zeros tfia VSN aiyst be 
eiiclostd in string qyotes <♦!« If tlia file Is a 
pyltl-rael tape* than the list of t«Pts «yst l3# toelossd 
I n D ^ r ^ f? 1 1^ f s i ^ • 
SxtfBPle TPF*C'0C0i23».f 543210) Default oonsf 

one Qf TPF and OTF 
rayst b% sptol li e€« 

This flSs will contain the coynter statistics* 

iManpIt CNF = QKI^CNT Otfsylt OKPCNT. 

This pifiifiatar fllo^s specifying i titit of yp to %C 

chsf acters* 

E%m9iB TIT=*PMF RUM FOR FMil« Defaylt l>«F RUH. 

HiPt of file whsrt tht o!}Jt?5t cods for KKPCI^T Is fcynd* 
Ordinarily ttuls ptraaseter Is obtained froii tJie *tooHlb« 
parinitter in tli€ user's PRQFIlg* Tills ptrafs^ttr Mcyfd 
ordinarily fee used for testing a ne"*<i version of tti€ 
pr ipr ootssort or for use of a specially modified version 
of the preprocessor* 
gxample ll8«HfLia Default XULI8* 

Ijssr nufibtr i*-ti«rt flls specified by LIS (afeove) resides* 
Orcflnarlly this parameter Is olsttined froffl the •toolset* 
partffleter In the user*s ftOFILS* 
SKiWPit LISUH^UNIZ Default KiYPtRF* 



FolliOMirig are soma exaiuples of how to Invoke Kl 



SeS.KPCNT DTF»DATAFi 



SES*KPCMT TFF«AaC001 



This ctll mHI gat file OITIFlf 

generate the statistics and 
dispose the output to the 
printer* 

This call will submit a jofe to 
request tape kBCQQl$ generate 
the statistics and dispose the 
output to the pr I nttr* 
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13.0 STATISTICS FACILITY 



13 • 3 siiiiiims-Eikauii 



T(j b a su PP I I €Cl« 
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€ s I g n 



Control Data Private 



Psrfofiiafsee Rtporting Facility £RS 



24 Fti 84 



Ai«« APPENDIX A — S¥l USAGE 



A 1 . i£Email«4«r=«SIi«USl££ . 



Th« master iccoynt for PRF utilltlts tt $y?^r»y¥tlt Is KiYjsERf* 

3~$ Procedyres desert i3€d in this docwweottt Ion fflty b« ryn by 
tyolm l?S»KEYP6RF.ytli ity name or by pytting KgYPEtF Into th€ 
sairnh oat^ In 3»oyr PRQFILS* CCL proos isif ba ofetaintd b.y 
4C0UIR-# PR3C^Il/yN=KEYP£PF and tiier* running these procs as 
iltssf ibid. 

In ordar to run PHF dati coHtotlon on SNIOI tn<l SM1§2> ?HF nust 
t>t invoktd froin the consols under OIS prior to running the Jcis to 
bi! monltor«<l» Tht s«<|u«nce to do this Is «s follows? 

PHFCr^«COlLeCTfTp=f:sn| 



Data collection Is actually Initiated by the first class 15 
kaypoint tncoynt®r«d by tha PHF hircli#ir« snd stopped by the 
sacond one* If# for some raason* the coHectlon does not stop* 
it ity bt ttrinlniteci by 

Cl=Of Jsn.STOP . 

or as a last resort by 

OROPfJsn. 
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Sl.O A^^e^^lIX e -- COLLECTICn RUH 



a. i£E.£iail^l.=r^i:flLki£lICli.Elli 



IN I s 



««a?ipl® shows fiON to start and stop a ksypoint colltctlor? 



3B$*Pm TY«COLLiCT 



■ictk 



f hfS f mm- iZ9 3*B 99 f 15} «• 



«icet 
detk 



f s 



from 17© sidt# to sat yp PfiF 

fro!« 18 side* ta eiiable 

k®ypoi?it eolltctlof^f 

frofa 18§ sld8# to Issut 

kpt«: class 15 to start 

col I «ctioii* 

froii 18© side# start benchmBrkp 

from 18© sids# mh^n benchmark 
ttr«lnit«il» to stop cot I action* 
froii 180 side* to deactivate tha 
keypolnt collection* 
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